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PREFACE 


This  manual  is  based  on  the  URA  User's  Manual  prepared 
for  the  Air  Force  by  the  University  of  Michigan  under 
contract  F19628-74-C-0171.  It  differs  from  the  University 
of  Michigan  product  in  so  far  as  it  concerns  use  of  URA 
software  with  IBM  OS/TSO  system  software  as  opposed  to  the 
Michigan  Terminal  System  (MTS)  software.  The  manual  is 
intended  to  be  used  in  conjunction  with  ESD  TR  75-88/  Vol  I, 
"Introduction  to  Computer  Aided  Requirements  Analysis"/  and 
ESD  TR  75-88/  Vol  11,  "URL  USERS  MANUAL". 

It  is  the  goal  of  this  manual  to  assist  the  User 
Requirements  Analyzer  (URA)  user  In  effectively  manipulating 
the  URA  command  language  as  specified  tn  Part  II  "URA 
Command  Descriptions".  It  is  intended  as  an  aid  through  all 
stages  of  the  URL/URA  requirements  specification  phase  of 
system  development.  The  manual  specifies  the  steps  in 
creating  the  URL  database;  i.e./  inputting  URL  statements, 
modifying  the  contents  of  the  database,  generating  outputs, 
and  correcting  syntactical  and  logical  errors.  It  provides 
all  information  necessary  to  use  URA  in  conjunction  with  the 
IBM  370/158/OS/TSO  system.  The  original  ESD  version  of  URA, 
2.0,  is  addressed.  The  document  contains  the  following 
mater i al : 


Part  1 - URA/Version  2.0  Operat i ng/ Procedu res 

for  IBM  370/158/OS/TSO  Installations 

This  part  contains  all  Information  necessary  to  use 
the  software  under 


A 


OS/TSO.  It  is  TSO-dependent , and 
requires  modification  by  the  user  to  fit 
his  own  installation. 


Part  II  - User  Requirements  Analyzer 

Command  Descriptions 

This  is  a summary  of  the  URA  commands 
available,  with  their  syntax  and 
parameters. 

Part  III  - URA  Outputs 

This  part  discusses  the  purpose  and  uses 
of  each  URA  report,  along  with  the  way 
the  reports  fit  into  the  requirements 
specification  process. 


HENRY' J.  E I DEN, 
Program  Manager 
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URA  VERSION  2.0  OPERATING  PROCEDURES 

FOR 

IBM  370/158/OS/TSO  INSTALLATIONS 
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Introduction 


The  first  phase  in  using  the  URL/URA  system 
deals  with  specifying  a user  requirement  with  URL 
statements.  The  second  phase  is  concerned  with 
using  URA  to  enter  the  user  requirement  into  a 
computer  analyzable  format.  URA  extracts 
information  from  these  URL  statements  and  stores 
it  in  a URA  database.  Once  this  information  (a 
user  requirement)  is  in  the  database,  it  can  be 
modified,  new  information  can  be  added  to  it,  and 
reports  can  be  generated  presenting  the  status  of 
the  user  requirements.  These  actions  are 
implemented  by  the  URA  commands  available  in  the 
URA  (processing)  mode.  This  mode  of  operation  may 
be  attained  by  accessing  the  URA  software 
available  in  TSO.  Therefore,  by  understanding  the 
TSO  commands  that  interact  with  URA,  and  the  URA 
command  language,  the  user  can  effectively 
manipulate  the  contents  of  a URA  database. 

This  part  of  the  manual  specifies  those  TSO 
commands #commonly  used  in  i.  acting  with  URA  and 

how  to  use  them.  It  also  se/  is  as  a guide  to 
using  the  URA  commands.  Since  here  is  such  a 
large  number  of  options  and  ai  natives  available 
in  using  each  URA  command,  only  those  which  are 
most  useful  to  the  user  are  presented.  The  reader 
should  be  made  aware  that  both  TSO  and  URA 
commands  are  specified  in  this  manual  and  each  set 
of  commands  can  only  be  used  in  its  respective 
(processing)  mode.  TSO  commands  can  be  used  from 
time  of  signing  on  to  TSO,  to  the  time  access  to 
the  URA  software  is  acquired.  At  this  point,  only 
URA  commands  may  be  used  until  the  user 
temporarily  returns  control  to  TSO  (by  hitting  the 
ATTENTION  or  BREAK  key)  , or  terminates  processing 
to  be  done  in  URA  mode  (through  use  of  the  URA 
"STOP"  command)  . TSO  commands  can  then  be  used  up 
to  the  time  of  signing  off  TSO.  This  interaction 
between  TSO  and  URA  modes  is  better  illustrated  by 
Figure  1.  To  aid  the  reader  in  differentiating 
between  TSO  and  URA  commands,  note  that  all  URA 
commands  will  be  indented  farther  than  any  TSO 
commands  with  which  they  may  appear.  At  the 
terminal  this  indentation  is  not  necessary  and  is 
provided  here  only  for  the  sake  of  clarity. 


The  format  of  this  part  serves  an  important 
purpose.  The  first  five  sections  deal  with  TSO 
and  URA  at  an  introductory  level.  Section  1 
presents  necessary  information  to  the  basic  use  of 
the  IBM  370/1 58/OS/TSO.  Section  2 explains  the 
procedure  of  accessing  URA  once  on  TSO.  Section  3 
provides  an  introduction  to  the  next  five 
sections.  Sections  4 and  5 present  practical 
concepts  and  conventions  to  be  known  before  using 
URA.  Once  access  to  URA  has  been  achieved. 
Sections  6,  7 and  8 present  the  procedures  needed 
to  implement  the  various  commands  available. 
Several  examples  are  given  in  these  sections  in 
order  to  better  illustrate  the  results  of  specific 
implementations.  Sections  9 and  10  deal  with 
handling  errors  encountered  in  the  use  of  URA. 
Appendix  A of  Part  I presents  several  procedures 
to  aid  in  the  task  of  modifying  the  URA  database. 
Appendix  B presents  a list  of  all  URA  commands 
available  (and  the  parameters  for  each  command)  as 
well  as  the  abbreviations  for  all  these  to  serve 
as  a guick  reference.  Throughout  this  manual  the 
long  form  of  URA  commands  and  parameters  are  used 
interchangeably  with  their  abbreviations.  The 
sections  are  ordered  then,  in  the  manner  in  which 
the  userfwill  be  using  the  two  systems  (TSO  and 
URA)  and  from  basic  introductory  material  to 
specific  information  dealing  with  a particular 
aspect  of  usage  (using  the  TSO  editor,  for 
example) . Therefore,  as  the  user  of  TSO/URA 
becomes  more  and  more  familiar  with  the 
implementation  of  those  systems,  the  latter 
sections  and  appendices  will  be  in  more  use  than 
the  introductory  sections. 


TSO  Mode 


I l (other  TSO 
I I commands) 


INTERRUPT 


EXEC  URA 


(other  URA 
commands) 


URA  Mode 


TSO  Mode 


(other  TSO 
commands) 


(other  URA 
commands) 


URA  Mode 


TSO  Mode 


(other  TSO 
commands) 


LOGOFF 


FIGURE  1 . Interaction  between  TSO  and  URA  processing  modes 


1 . 0 Using  TSO 

The  following  three  subsections  are  intended 
to  introduce  the  reader  to  the  IBM  370/1 58/OS/TSO. 
To  those  readers  already  acquainted  with  the 
system,  these  sections  may  be  ignored  as  they  only 
present  fundamental  concepts.  For  those  readers 
new  to  the  system  these  sections  present  a biased 
view  of  TSO  (oriented  directly  towards  use  with 
URA)  by  omitting  TSO  commands  and  command 
parameters  that  will  be  of  little  or  no  benefit  to 
the  user  using  URA. 

A complete  description  of  all  TSO  and  EDIT 
commands  may  be  found  in: 

IBM/360  Operating  System: 

Time  Sharing  Option 
Command  Language  Reference 

While  this  URA  manual  provides  the  information 
needed  tof  operate  URA  under  TSO,  it  may  at  times 
be  necessary  to  refer  to  the  above  manual  for  more 
complete  descriptions  of  those  TSO  commands  used 
with  URA. 


y 


1.1  A Brief  Overview  of  TSO 

In  general,  the  URA  user  will  be  concerned 
either  with  the  running  of  URA  or  the  preparation 
of  datasets  as  inputs  for  the  various  URA 
commands.  In  the  former  case,  URA  is  called  and 
initiated  by  issuing  the  EXEC  URA  command. 
Preparation  of  datasets  for  use  in  URA  is 
accomplished  by  issuing  the  EDIT  command  and 
giving  the  desired  dataset  name.  The  concern  of 
the  following  sections  is  to  provide  information 
relative  to  the  TSO  EDIT  commands  and  other  basic 
TSO  commands  as  they  relate  to  running  URA. 

I!§Q  Command  Language 

In  any  terminal  session  it  is  first  necessary 
to  LOGON.  Once  this  has  been  accomplished,  the 
user  has  the  computer  at  his  command.  This 
section  lists  the  commands  in  their  most  common 
form  followed  by  a brief  explanation. 

NOTE:  A>1  dataset  names  in  this  section  have  been 

given  dataset  type  ".DATA"  as  the  great  majority 
of  user  defined  datasets  will  be  of  this  type.  In 
general,  user  defined  dataset  names  will  consist 
of  an  up  to  eight  character  user  name  and  a 
dataset  type. 

A.  Global  Control 

LOGON  TSXXXX  tells  TSO  that  ID 

number  TSXXXX  wishes 
to  LOGON.  TSO  will 
then  prompt  the  user 
for  the  password 
associated  with  the 
ID. 

LOGOFF  tells  TSO  to  sign  the 

user  off  and  print  a 
summary  of  run 
statistics. 


; 
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SIZE  (XXX)  Controls  the  amount 

of  space  the  user  has 
in  core  (for  running 
URA  the  user  must 
enter  size (246)  which 
gives  him  246K  of 
core)  . 

PROC  (XXX)  Tells  TSO  that 

procedure  "XXX"  will 
be  used  (for  running 
URA  PROC  (URA)  is 
specified  which 
allocates  sufficient 
datasets  to  run  all 
URA  reports) . 

tells  TSO  that 
terminal  number  "XX" 
is  being  used  (only 
for  IBM  2741 
terminals)  . Any 
number  1-99  may  be 
used. 

NOTE:  If  either  of  the  last  two 

statements  are  not  given  in  user  LOGON, 
the  user  will  be  prompted  for  them.  No 
prompt  will  be  given  if  the  size  is  not 
set. 

B.  Program  Control 

EXEC  XXX  tells  TSO  to  load  and 

execute  program  XXX. 
The  user  will  most 
frequently  use  EXEC 
URA  or  EXEC  CLI. 

FREEALL  releases  all 

allocated  datasets 
(should  be  given 
after  issuing  an  ATTN 
Interrupt  to  exit 
URA)  . 


TERM  (XX) 


c 


Data  Set  Handling 
EDIT  XXX. DATA 


l 

i 


creates  a dataset 
named  "XXX. DATA"  if 
one  does  not  already 
exist.  If  one  does 
exist,  tells  TSO  to 
put  the  editor  in 
charge  in  order  to 
modify  XXX. DATA.  A 
complete  list  of  EDIT 
commands  follows  this 
section. 


DELETE  XXX. DATA  destroys  the  dataset 

named  XXX. DATA. . 

RENAME  XXX. DATA  YYY. DATA  changes  the  name 

XXX. DATA  to  YYY. DATA. 

COPY  XXX. DATA  YYY.  DATA  copies  all  of  the 

contents  of  dataset 

' XXX. DATA  to  YYY. DATA. 

Any  information  which 
exists  in  the  data 
set  being  copied  to 
will  be  destroyed. 

MERGE  XXX. DATA  YYY. DATA  copies  all  or 

parts  of  dataset 
XXX. DATA  to  YYY. DATA. 
Line  numbers  may  be 
given  to  state  which 
line  numbers  are  to 
be  taken  from 
XXX. DATA  and  after 
which  line  in 
YYY. DATA  they  are  to 
be  written.  No 
information  in 
YYY. DATA  is  changed 
or  lost. 


LIST  XXX. DATA  lists  the  contents  of 

dataset  XXX. DATA  at 
the  terminal. 

EDIT  Command  Language 

The  TSO  editor  is  used  to  create  datasets  to 
be  input  to  URA  or  to  modify  existing  datasets  in 
order  to  correct  errors.  The  editor  thus  has  two 
modes:  INPUT  for  putting  lines  into  the  dataset 
and  EDIT  for  changing  lines  in  the  dataset. 

If  the  user  wished  to  create  a dataset  to  be 
used  by  URA,  he  will  use  the  command: 

EDIT  URA. DATA 

This  line  tells  the  computer  that  a dataset  named 
"URA"  with  dataset  type  ".DATA"  is  to  be  editted. 
Since  the  dataset  is  a new  one,  TSO  will  be  unable 
to  find  a dataset  with  this  name  and  will  respond 
with: 

« 

ENTER  NEW  or  OLD 

to  which  the  user  should  respond  "NEW"  before 
hitting  the  carriage  return.  The  "NEW"  statement 
tells  the  computer  that  the  dataset  is  a new  one 
and  that  it  should  respond  in  INPUT  mode  so  that 
the  user  may  type  lines  into  the  dataset.  TSO 
will  then  print  INPUT  at  the  terminal  followed  by 
00010  and  wait  for  the  user  to  provide 
information.  After  each  carriage  return,  TSO  will 
print  out  the  next  line  number  in  increments  of 
ten.  If  the  user  inadvertently  specifies  a 
dataset  name  which  he  has  already  used  and  uses 
the  NEW  statement  the  computer  will  respond  with: 

EDIT 

and  will  wait  for  EDIT  commands.  The  above 
procedure  assures  that  the  user  will  not 
inadvertently  destroy  a dataset  by  creating  a new 
dataset  with  an  old  name.  The  user  should  receive 
the  ENTER  NEW  OR  OLD  line  if  the  name  is  actually 
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a new  one.  If  it  is  not  received  (in  which  case 
EDIT  will  be  printed  out) , the  user  should  realize 
that  he  has  chosen  a previously  defined  name  and 
should  choose  another. 

If  the  user  is  sure  that  the  dataset  name  has 
not  been  used  before,  he  may  abbreviate  the 
creation  of  the  dataset  by  entering: 

EDIT  URA. DATA  NEW 

to  which  TSO  will  respond: 

INPUT 

00010 

The  user  is  cautioned  however  that  if  he  has 
chosen  a previously  defined  dataset  name,  the 
information  contained  in  that  dataset  will  be 
destroyed. 

If  abuser  wishes  to  change  a dataset  he  has 
already  created,  he  need  only  enter: 

EDIT  XXX. DATA 

TSO  will  then  type  EDIT  out  at  the  terminal  and 
wait  for  the  user  to  specify  EDIT  commands.  The 
following  give  a brief  description  of  the  various 
EDIT  commands  (synonyms  are  given  in  parenthesis 
after  the  command) . 

A.  Commands  Which  Move  the  Line  Pointer 


BOTTOM  (B) 


DOWN  nl 


LIST  (L)  nl  n2 


moves  the  pointer  to 
the  bottom  of  the 
dataset. 

moves  the  pointer 
down  nl  lines. 

causes  editor  to  list 
lines  nl  through  n2 
and  causes  pointer  to 
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point  to  n2.  If  n2 
is  not  given,  the 
pointer  will  point  to 
and  list  line  number 

nl. 

TOP 

moves  the  pointer  to 
the  top  of  the 
dataset. 

UP  nl 

moves  the  pointer  up 
nl  lines. 

FIND  (F)  "STRING" 

cause  the  editor  to 
search  line  by  line 
until  it  finds  the 
string.  Line  pointer 
points  to  line  in 
which  the  string  is 
found.  If  the  string 
is  not  found  "TEXT 
NOT  FOUND",  is 

* 

printed  out  and  the 
pointer  returns  to 
the  position  it  had 
before  the  FIND 
command  was  issued. 

B.  commands  Which  Change  Characters  Within  a 

Line 

CHANGE  n 1 /STRING 1 /STRING 2/  replaces 

string  1 with  string 
2 in  line  number  nl. 
One  may  also  specify 
a line  number  range 
and  specify  that  all 
occurrences  of  string 
1 be  replaced  by 
string  2. 

C.  Commands  Which  Change  Entire  Lines 

DELETE  nl  deletes  line  number 

nl  from  the  dataset. 
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A line  number  range 
may  also  be  given. 

INSERT  inserts  the  data 

provided  immediately 
following  the  line 
being  pointed  to. 

Insert /Replace/Delete 

allows  insertion, 
deletion  or 
replacement  of  lines 
by  typing  a line 
number  and  the  new 
information.  If  the 
line  number  already 
exists,  the  new  line 
will  replace  the  old 
line.  If  the  line 
number  does  not 
exist,  one  will  be 
created.  If  the  line 
* number  exists  and  no 

information  is  given, 
the  line  is  deleted. 

D.  Commands  to  Change  Mode  or  Leave  EDIT 

Mode 

INPUT  switches  to  INPUT 

Mode,  starts  line 
numbering  after  last 
line  of  dataset. 

SAVE  saves  all  changes  and 

inputs  to  the 
dataset. 

END  returns  to  TSO  for 

further  TSO  commands. 

RETURN  hitting  the  carriage 

return  with  no  input 
line  will 

automatically  switch 
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from  one  EDIT  mode  to 
the  other. 


E.  Miscellaneous 

VERIFY  (V)  with  the  CHANGE 

Command,  causes  the 
line  in  which  the 
change  has  been  made 
to  be  printed  out. 
With  the  FIND  command 
causes  the  line  in 
which  the  string  has 
been  found  to  be 
printed  out. 

renumbers  the  dataset 
in  intervals  of  10. 
User  may  also  give 
range  within  a data 
set  to  be  renumbered 
and  may  specify  any 
integer  interval  he 
wishes. 

1.2  Interactive  Use  of  TSO 

Interactive  use  of  TSO  will  commonly  be 
through  the  use  of  IBM  2741  Terminals  or  smaller 
portable  terminals  such  as  the  CDI  Teleterm  300. 
The  use  of  either  type  terminal  is  virtually 
identical  after  the  user  has  logged  on.  There 
are,  however,  some  differences  in  the  initiation 
sequence  which  will  be  mentioned  below. 

Initiating  a Terminal  Session 

Before  dialing  up  the  computer,  it  is 
necessary  that  whichever  terminal  is  being  used  be 
set  up  to  talk  with  TSO.  If  an  IBM  2741  is  being 
used  with  a dataphone,  it  is  only  necessary  to 
assure  that  the  two  switches  on  the  left  side  of 
the  terminal  be  set  to  COM  and  AUTOEOT  OFF.  If 
these  switches  are  not  set  properly,  no  connection 
will  be  made.  If  an  IBM  2741  is  being  used  with 
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an  accoustic  coupler,  it  is  necessary  that  the 
coupler  be  turned  ON  and  set  to  HALF-DUPLEX.  If  a 
portable  terminal  is  used,  it  should  be  set  to 
HALF-DUPLEX  and  30  cps.  In  every  case,  the 
terminal  should  be  turned  on  before  dialing  the 
computer. 

In  order  to  initiate  a terminal  session,  the 
user  must  then  dial  into  TSO  via  the  telephone 
lines.  Infrequently,  the  phone  lines  will  be 
busy.  This  generally  means  either  that  all  lines 
to  the  computer  are  temporarily  filled  or  that  TSO 
is  not  operating.  If  a busy  signal  is  received, 
hang  up  and  call  again  in  a few  minutes.  If  a 
busy  signal  is  still  received,  it  is  probable  that 
TSO  is  down.  In  the  latter  case,  a recorded 
message  is  sometimes  placed  on  the  line  saying 
that  TSO  is  down  and  giving  some  indication  as  to 
when  it  will  return.  If  the  computer  number  rings 
but  does  not  answer,  it  is  likely  that  TSO  is  in 
the  process  of  going  down,  hang  up  and  try  again 
later. 


Assuming  the  lines  are  not  busy  and  the 
computer  is  up,  the  user  will  generally  hear  one 
or  two  rings  and  then  a high  pitched  tone.  If  an 
IBM  2741  is  being  used  with  a data  phone,  the  user 
should  depress  the  DATA  button  when  he  hears  the 
tone.  If  an  accoustic  coupler  is  being  used  with 
either  an  IBM  2741  or  a portable  terminal,  the 
handset  should  be  fit  snugly  into  coupler  after 
the  tone  is  heard. 


If  all  has  gone  well,  TSO  should  then  respond 
with  "WHICH  SYSTEM  DO  YOU  WANT".  If  It  does  not, 
there  is  probably  a switch  set  wrong  and  all 
switches  should  be  checked  before  dialing  in 
again.  The  user  should  then  type  TSO  and  hit  the 
RETURN  key.  After  this,  TSO  responds  with: 

ENTER  LOGON 


At  this  point,  the  user  should  enter  the  following 
line: 


LOGON  TSXXXX  SIZE(246)  PROC  (URA)  TERM  (XX)  . 


where  TSXXXX  is  the  user's  account  number, 
size  (246)  reserves  24bK  of  core,  PROC (URA) 
allocates  a sufficient  number  of  datasets,  and 
TERM (XX)  tells  TSO  wnich  terminal  is  being  used. 

If  the  user  neglects  to  enter  the  PROC  and  TERM 
statements,  he  will  be  prompted  for  them.  If  the 
terminal  number  is  not  known,  any  number  between  1 
and  99  may  be  used.  After  entering  this  line,  TSO 
checks  to  make  sure  TSXXXX  is  a valid  account 
number,  if  so,  it  responds  with: 

ENTER  PASSWORD  FOR  TSXXXX. 

It  then  returns  the  carriage  and  prints  out 
some  characters  to  mask  the  user  password.  The 
terminal  will  make  three  passes,  filling  up  eight 
spaces  with  characters  and  then  wait  while  the 
user  types  his  password  and  then  hits  RETURN. 

If  the  password  is  incorrect,  the  user  will  be 
told  so  £nd  asked  to  re-enter.  If  the  password  is 
correct,  the  terminal  will  usually  print: 

TSXXXX  LOGON  IN  PROGRESS  AT  (time)  ON  (date) 

NO  BROADCAST  MESSAGES 
READY 

Occasionally,  there  will  be  a broadcast 
message  (such  as  "TSO  WILL  BE  DOWN  NOON  HOUR") , 
and  there  may  be  some  delays  after  entering  the 
password  and  before  the  READY  is  received.  These 
occur  mainly  when  the  system  is  busy. 

Once  the  terminal  responds  with  READY,  the 
user  is  able  to  execute  TSO  and  URA  commands.  If 
a user  is  on  a terminal  whose  line  size  is  less 
than  120  characters,  it  is  necessary  that  he 
inform  the  computer  of  this  fact.  If  he  does  not 
upon  execution  of  any  URA  commands,  an  error  will 
be  generated  and  the  URA  program  will  abort.  To 
prevent  this,  the  user  should  enter  the  line: 

TERM  LINESIZE  XX 


where  XX  is  tne  number  of  characters  per  line  for 
the  terminal  and  then  hit  RETURN,  after  which  the 
computer  responds  with  READY. 

Terminating  a Session 

Once  the  user  is  finished  at  the  terminal,  it 
is  necessary  that  he  sign-off.  This  is  done 
simply  by  typing  LOGOFF  and  hitting  RETURN.  It  is 
necessary  that  the  user  be  in  TSO  when  this 
command  is  issued.  If  he  is  still  in  URA,  an 
error  message  will  be  generated.  The  user  should 
then  enter  the  STOP  command  of  URA,  wait  until  he 
receives  a READY,  and  then  enter  LOGOFF.  The 
terminal  will  then  print: 

XXXX  CORE  USED  XXTGETS  XX  TPUTS  XX  DISC  EXCPS 
JOBLOG  XXXXXXXXXXXX  X.XXCPU  SECS  XXX. XX  ELAPSED 
SECS 

TSXXXX  LOGGED  OFF  TSO  AT  (time)  ON  (date)  + 

where  thg  X's  represent  various  numbers.  TSO  will 
then  hang  up  and  the  user  should  turn  off  the 
terminal . 

\ Attention  Interrupts 

The  ATTN  (or  BREAK)  key  may  be  used  anytime 
after  the  user  has  successfully  logged  on  and 
before  he  enters  the  LOGOFF  command,  to  interrupt 
whatever  processing  is  being  done  by  TSO  (or  URA) 
at  the  time  and  return  to  the  terminal  for  TSO 
commands.  One  common  use  is  to  get  out  of  URA  to 
create  or  edit  files  to  be  used  by  URA  later  on 
during  the  same  terminal  session.  After  hitting 
the  ATTN  key,  there  will  be  a short  delay  until 
the  terminal  responds  with  a READY.  At  this 
point,  any  necessary  TSO  commands  may  be  run. 

When  the  user  wishes  t.o  return  to  URA,  he  should 
enter: 

EXEC  CLI 

which  will  act  as  a restart.  The  only  caution  is 
against  using  an  ATTN  interrupt  while  a database 
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modification  (adding  or  removing  data  from  a URA 
database)  is  being  run.  In  these  cases,  the 
possibility  exists  of  causing  the  database  to 
become  irrecoverably  unusable . 


NOTE:  For  sake  of  economy,  the  user  should  enter 

a FREEALL  upon  receiving  a READY  after  an 
Attention  Interrupt.  This  step  is  not  always 
necessary  but  will  make  the  EXEC  CLI  restart 
execute  more  efficiently. 


\ 


\ 
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1.3  Batch  Use  of  OS 


Information  on  the  batch  use  of  URA  OS  will  be 
provided  as  an  attachment  to  this  manual  when  this 
information  becomes  available. 


2.0  Initiating  URA 


The  preliminaries  involved  in  initiating  URA 
are  very  straight  forward: 

a.  The  URA  database  file  must  be  created  and 
initialized. 

b.  URA  mode  must  be  entered  so  that  URA 
commands  may  be  used  to  access  the 
database. 

c.  The  database  to  be  accessed  by  the  URA 
commands  must  be  assigned  by  way  of  the 
SET  command. 

Assuming  that  the  user  is  already  logged  on 
TSO  and  the  name  of  the  database  will  be  URADB, 
the  previous  three  steps  are  carried  out  by  the 
following  statement: 

EXEC  NEwSb  ' uradb. database' 

EXEC  URA 

SET  DB=uradb. database 

The  EXEC  NEWD3  command  is  only  given  when  a new 
database  is  to  be  created  and  is  not  needed 
subsequently.  The  TSO  response  to  this  command 
will  be: 

DATABASE  INITIALIZED  WITH  150  PAGES 
READY 

The  EXEC  URA  command  is  used  whenever  the  user 
wishes  to  enter  URA  in  order  to  implement  any  of 
the  URA  commands  specified  in  Part  II. 

The  SET  command  is  a URA  command  which  tells 
URA  which  database  is  to  be  accessed. 

URADB. DATABASE  is  the  default  value  if  this 
command  is  not  specified.  If  another  database  is 
specified,  it  will  be  used  until  the  user  exits 
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URA  (either  by  a STOP  or  an  ATTN  interrupt) , or 
until  another  SET  DB  command  is  given. 

After  the  EXEC  URA  command  is  given  and  after 
the  completion  of  each  URA  command,  the  user  is 
prompted  with: 

ENTER  COMMAND  (AND  ANY  PARAMETERS) , 

after  which  the  carriage  returns  and  waits  for  the 
user  to  enter  the  next  command. 

If  the  user  wishes  to  temporarily  exit  URA  to 
return  later  in  the  same  terminal  session,  an  ATTN 
interrupt  may  be  given  which  will  return  the  user 
to  TSO.  After  the  user  is  finished  with  TSO 
commands,  he  may  re-enter  URA  by  typing: 

EXEC  CLI 

which  will  act  as  a restart  to  URA. 

To  terminate  the  URA  session,  the  user  should 
use  the  STOP  command  (not  the  interrupt) , which 
will  return  him  to  TSO.  Once  in  TSO,  he  may  do 
whatever  TSO  commands  he  wishes  and  then  logoff, 
ending  his  terminal  session. 

The  final  section  represents  a sample  terminal 
session  roughly  following  the  diagram  found  at  the 
end  of  the  introduction  (Figure  1) . It  is  to  be 
noted  that  while  the  session  appears  to  move  along 
swiftly  in  written  form,  there  will  be  delays  when 
it  is  being  run.  The  user  should  expect  delays  of 
some  length  after  the  EXEC  URA  and  STOP  commands 
and  lesser  delays  after  other  TSO  and  URA 
commands,  particularly  if  TSO  is  busy. 

Sample  Terminal  Session 

In  the  following,  computer  responses  are  in 
capital  letters,  user  provided  information  in 
small  letters. 

(Dial  up  TSO,  depress  DATA  button  upon  hearing  tone) 


WHICH  SYSTEM  DO  YOU  WANT? 


t 
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tSO 

ENTER  LOGON 

logon  tso593  size  (246) 

ENTER  PASSWORD  FOR  TS0593 

kkkhkkkto  (password  typed  over  mask  provided  by  TSO) 
ENTER  PROCEDURE  NAME  - ura 
ENTER  TERMINAL  NUMBER  - 9 

TS0593  LOGON  IN  PROGRESS  AT  11:44:32  on  FEB  29,  1975 

NO  BROADCAST  MESSAGES 

READY 

exec  new^b  'uradb. database' 

DATABASE  INITIALIZED  WITH  150  PAGES 

READY 

exec  ura 

URA  VERSION  2.0 

ENTER  COMMAND  (AND  ANY  PARAMETERS) 
set  db=ura.  database 
ENTER  COMMAND  (AND  ANY  PARAMETERS) 

| (other  URA  commands) 

ENTER  COMMAND  (AND  ANY  PARAMETERS) 
i (ATTN  interrupt) 

READY 
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READY 


| (TSO  commands) 
exec  cli 
URA  VERSION  2.0 

ENTER  COMMAND  (AND  ANY  PARAMETERS) 

(URA  commands) 

ENTER  COMMAND  (AND  ANY  PARAMETERS) 

stop 

READY 

logoff  * 

200K  CORE  USED  122  TGETS  150  TPUTS  648  DISK  EXCPS 
JOBLOG  750594272220  11.3  CPU  SECS  600.48  ELAPSED  SECONDS 
TS0593  LOGGED  OFF  TSO  AT  11:55:20  CN  FEBRUARY  29,  1975  + 


NOTE:  The  LOGON  may  be  abbreviated  by  entering 

the  line  logon  ts0593  size  (246)  proc (URA) 
term  (97)  , instead  of  the  LOGON  entered  in  the 
sample. 


3 . 0 The  URA  Command  Language 

The  URA  Command  Language  consists  of  three 
basic  types  of  commands: 

Report  Commands 

Modifier  Commands 

Control  Commands 

Report  commands  retrieve  data  from  the  URA 
database  and  output  it  in  some  meaningful  format. 
These  reports  do  not  change  the  contents  of  the 
database  whatsoever.  Their  purpose  is  solely  that 
of  displaying  orderings  and/or  relationships, 
within  the  current  user  requirements. 

Modifier  Commands  are  intended  to  modify  the 
contents  of  the  URA  data  base  in  the  manner 
defined  by  the  user.  These  commands  take  legal 
URL  statements  or  URL  names  as  input.  URA  then 
generated  error  diagnostics  as  well  as  an  output 
report  to  present  the  outcome  of  the  database 
alteration. 

Control  Commands  are  the  means  to  pass  certain 
control  information  to  the  User  Requirements 
Analyzer.  The  SET  command,  for  example,  allows 
the  user  to  define  which  URA  database  is  to  be 
accessed  by  the  Report  and  Modifier  Commands  as 
well  as  setting  various  switches  and  assigning 
input  and  output  files. 

Although  any  of  the  commands  can  be  issued 
independently  of  each  other,  it  is  often 
advantageous  to  use  some  commands  in  sequence. 

This  means  that  output  of  one  command  can  be  used 
as  input  by  another.  The  most  common  instance  of 
this  is  when  NAME-GEN  is  used  to  select  certain 
names  (say  all  PROCESSES  for  example)  which  can 
then  be  used  as  input  to  a Report  Command 
(possibly  PICTURE,  for  a PICTURE  REPORT  for  all 
PROCESS  names) . 
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The  HELP  Command 

The  HELP  command  provides  the  user  with 
information  about  the  syntax  and  parameters  of  URA 
commands.  When  the  user  enters  HELP,  the  system 
displays  a list  of  all  available  URA  commands  and 
their  abbreviations.  By  specifying  a particular 
URA  command  name  as  a parameter  to  the  HELP 
command: 


HELP  CONTENTS 

for  example,  all  the  parameters  available  for  this 
command  will  be  printed  out.  If  the  "LONG" 
parameter  was  given  in  conjunction  with  a command 
name: 


HELP  FPS  LONG 

all  parameters  for  the  FORMATTED- PROBLEM- STATEMENT 
would  be  printed  out  as  well  as  a description  of 
the  function  of  each  of  these  parameters  for  the 
command. * This  description  is  presented  in  the 
same  format  as  that  in  Part  II.  To  illustrate  an 
example,  when  "HELP  CONTENTS"  was  given  the 
following  information  was  printed: 

CONTENTS 

Prototype:  CONTENTS  (CONT)  (parameter)... 

Para mete rs: 

FILE  (dataset  name),  NAME (N) =user- name 


INDEX,  NOINDEX 


LEVELS=integer,  LEVELS=ALL 


NCFLAG , NONCFLAG 


Default: 

FILE 

Default: 

NOINDEX 

Default: 

ALL 

Default: 

NONCFLAG 
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4.0  Specifying  Input  to  URA  Commands 

For  most  commands  in  URA,  one  or  more  names 
(specified  by  the  user)  can  be  used  as  input  to 
the  command.  In  the  case  of  Modifier  Commands, 
the  modification  is  made  for  each  name  used  as 
input.  For  Report  Commands,  information  is 
retrieved  for  each  of  the  names  used  as  input. 
Except  for  the  INPUT-URL  command,  all  names  used 
as  input  to  the  Modifier  and  Report  Commands  must 
be  names  already  stored  in  the  user's  URA 
database . 

4.1  The  NAME  Parameter 

There  are  two  methods  of  specifying  names  to 
be  input  to  a command.  The  simplest  way  is  to  use 
the  NAME  parameter.  When  this  parameter  is  used, 
the  modification  will  be  made,  or  report  will  be 
generated,  for  only  that  name  specified  by  the 
NAME  parameter.  For  example,  if  NAM  E=  T-CARD  were 
used  for  the  DELETE  command,  only  T-CARD  would  be 
deleted  from  the  data  base.  Likewise,  if  NAME=T- 
CARD  were  used  as  a parameter  for  the  CONTENTS 
command,  the  CONTENTS  REPORT  would  be  generated 
for  the  name  T-CARD,  and  no  others. 

4.2  The  FILE  and  INPUT  Parameters 

The  second  way  to  specify  names  as  input  to  a 
URA  command  i s to  put  all  the  names  for  which  the 
modification  is  to  be  made,  or  report  generated, 
into  a file  and  specify  that  the  contents  of  that 
file  are  to  be  used  as  input  via  the  FILE  or  INPUT 
parameter.  FILS  and  INPUT  are  different  in  the 
way  names  can  be  formatted  within  the  file 
specified  by  these  parameters.  When  using  the 
FILE  parameter,  each  name  in  the  specified  file 
must  begin  in  the  first  column,  of  each  line,  of 
the  file  and  only  one  name  per  line  is  allowed. 

The  format  for  files  specified  by  the  INPUT 
parameter  varies  accordingly  to  the  URA  command 
using  this  parameter.  For  example,  if 
INPUT=IFILE. DATA  were  used  as  a parameter  for  the 
INPUT-URL  command,  the  file,  IFILE,  must  consist 
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of  URL  statements  to  be  entered  into  the  URA 
database.  For  those  Modifier  Commands  that  use 
the  INPUT  parameter,  the  particular  format  needed 
for  the  input  file  is  specified  in  later  sections. 

4.3  Entering  Data  Into  An  Input  File 

Before  specifying  a dataset  name  via  the  FILE 
or  INPUT  parameter,  one  must  go  through  the 
process  of  entering  data  into  the  dataset 
according  to  the  format  required  by  the  particular 
command.  In  order  to  enter  lines  into  a dataset, 
the  user  must  first  access  the  dataset  via  the 
EDIT  command  and  then  use  the  INPUT  mode  of  EDIT. 

If  the  user  is  creating  a new  dataset  (see 
last  section) , TSO  will  automatically  respond  in 
INPUT  mode.  If  the  user  is  adding  lines  to  an 
already  existing  dataset,  the  user  should  enter 
EDIT  mode  and  then  hit  the  carriage  return  again 
causing  TSO  to  automatically  switch  to  INPUT  mode. 

Once*in  INPUT  mode,  TSO  will  automatically 
increment  the  line  number  by  10  with  each  carriage 
return,  until  a blank  line  is  entered  at  which 
point  TSO  will  switch  to  EDIT  and  the  user  should 
issue  the  SAVE  and  END  commands.  If  the  SAVE 
command  is  not  given,  none  of  the  provided 
information  will  be  saved. 

The  procedure  to  create  a dataset,  copy  data 
into  it  and  destroy  the  dataset,  is  shown  in 
Example  4a.  All  uppercase  lines  are  TSO 
responses,  all  lowercase  are  typed  by  the  user. 

(R)  signifies  RETURN. 

edit  ura.data  (R) 

ENTER  NEW  OR  OLD-new  (R) 

INPUT 

00010  process  pi;  (R) 

00020  description;  (R) 
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00030  this  is  a process  to  be  used  (R) 
00040  in  my  problem  statement;  (R) 
00050  eof  (R) 

00060  (R)  (denotes  blank  line  return) 

EDIT 

save  (R) 

SAVED 
end  (R) 

END 

delete  ura.data  (R) 

READY 


« 

Example  4a 

As  in  most  cases,  the  above  can  be  abbreviated 
to  some  extent.  It  is  also  possible  to  eliminate 
the  automatic  line  numbering  by  using  the  NONUM 
command.  A similar  example,  this  time  without 
line  numbers,  is  found  in  Example  4b. 


edit  ura.data  new  nonum  (R) 

INPUT 

process  pi;  (R) 

description:  (R) 

this  is  a process  to  be  used  (R) 

in  my  problem  statement; 


(R) 


(R) 

EDIT 
se  (R) 

SAVED 

READY 

d ura.data  (R) 
READY 


Example  4b 

It  is  noted  that  the  EOF  is  necessary  for 
datasets  being  used  as  inputs  to  a INPUT-URL 
command.  Also,  SE  is  an  abbreviation  for  the  two 
commands  SAVE  and  END,  (D  is  an  abbreviation  for 
DELETE)  . 

4.4  Using  NAME-GEN 

Many  URA  commands  allow  or  require  a list  of 
user  defined  names  of  various  types  as  inputs  to 
the  command.  One  alternative  to  typing  in  long 
lists  of  names  is  to  allow  NAME-GEN  to  enter  the 
names.  The  various  parameters  for  NAME-GEN  (NG) 
allow  the  user  to  select  particular  types  of  names 
(such  as  all  the  GROUPS  and  ENTITIES)  and  have 
NAME-GEN  list  all  of  these  names  in  a dataset 
named  URANAMES.  The  names  are  formatted  one  per 
line  starting  in  the  first  column  of  the  line  as 
required  by  other  URA  commands.  The  contents  of 
URANAMES  may  then  be  used  as  input  to  a URA  report 
command.  This  may  be  accomplished  in  three  ways: 

1.  The  value,  URANAMES,  can  be 
specified  for  the  FILE  parameter  in  the  Report 
Commands : 

NAME-GEN  ENTITY  GROUP 
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CONTENTS  FI LE=  URANAMES 

2.  Specify  the  FILE  parameter  with  no 
corresponding  value,  when  no  value  is  assigned, 
URANAMES  is  taken  as  the  default. 

3.  Most  simply,  not  specify  anything. 

If  neither  NAME  nor  FILE  are  used  as  parameters, 
the  default  is  again  URANAMES.  For  example,  by 
specifying: 

NAME-GEN  ENTITY  GROUP 
CONTENTS 

in  sequence,  the  CONTENTS  REPORT  will  be  generated 
for  all  ENTITY  and  GROUP  names  in  the  URA  database 
as  shown  in  Example  4c.  The  contents  of  URANAMES 
remains  until  another  NAME-GEN  is  issued. 

The  above  may  be  further  abbreviated  using  URA 
abbreviations.  Thus: 

NG  ENT  GR 

CONT 

will  provide  the  same  output  as  found  in  Example 
4c. 

4.5  Using  PUNCH  Files 

PUNCH  files  are  datasets  which  have  formats 
acceptable  by  FILE  or  INPUT  parameters.  The  file 
described  in  the  previous  section,  URANAMES,  is  a 
PUNCH  f i le  from  the  NAME-GEN  command.  Output  from 
NAME-GEN  is  put  into  its  assigned  PUNCH  file  so 
that  it  may  be  used  as  input  to  any  of  the  FILE 
parameters  for  Modifier  and  Report  Commands.  The 
PUNCH  file  format  is  different  from  the  report 
format  for  the  command  that  generates  both  of 
them.  For  example,  implement  the  NAME-GEN  command 
for  all  PROCESSES.  The  report  generated  for  this 
request  will  consist  of  a report  heading,  line 
numbers  for  the  contents  of  the  report,  the  names 
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of  all  PROCESSES  in  the  database  and  their 
corresponding  name  type  (which  is,  of  course, 
PROCESS) . If  the  user  copies  the  contents  of  the 
PUNCH  file  produced  by  this  command: 

LIST  URANAMES 

all  that  will  be  in  this  file  is  the  names  of  the 
PROCESSES,  no  report  heading,  etc.  In  other 
words,  the  PUNCH  file  contains  similar  information 
to  the  report  from  the  command,  but  in  a format 
acceptable  to  the  FILE  and  INPUT  parameters  of 
other  URA  commands. 

NAME-GEN  PUNCH  output  does  not  have  to  be 
written  into  URANAMES.  This  is  merely  the  default 
PUNCH  file  for  NAME-GEN.  For  any  command  that 
utilizes  the  PUNCH  parameter,  a PUNCH  file  may  be 
specified  in  the  following  manner: 

PUNCH=dataset  name 

This  is  most  often  done  when  PUNCH  information 
from  the  FORMATTED- PROBLEM- STATEMENT  or  PRINT- 
COMMENT-ENTRY  command  is  desired.  The  information 
in  the  PUNCH  file  might  then  be  edited  and 
reentered  into  the  database.  The  following 
sequence  of  commands  is  common: 

PCOM  PUNCH= PUNCH  N=F-DATA  DESC 

EDIT  PUNCH 

CHANGE  20  /will  change  less/cannot  be  changed  more/ 

SE 

EXEC  URA 

RCOM  INPUT= PUNCH  N=  F-DATA 


The  DESCRIPTION  comment  entry  for  F-DATA  is 
written  into  PUNCH.  Minor  editing  is  performed  on 
the  DESCRIPTION  and  then  the  contents  of  PUNCH  is 
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used  as  input  the  the  RCOM  command  so  that  the  old 
DESCRIPTION  comment  entry  is  replaced  by  the 
modified  comment  entry  in  PUNCH.  Specific  usage 
of  the  PUNCH  parameter  is  given  in  the 
descriptions  of  the  individual  commands  that 
utilize  this  parameter. 
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5 . 0 Receiving  Output  From  URA  Commands 

When  generating  outputs  from  URA,  the 
information  is  put  into  a dataset  or  printed  on  a 
device  such  as  a line  printer  or  terminal.  If 
this  dataset  or  device  is  not  specified  (i.e.,  no 
dataset  is  assigned  to  the  OUTPUT  parameters  of 
the  URA  ••SET"  command)  then  all  outputs  are 
written  to  the  terminal  which  is  the  main  output 
file  or  device.  This  means  that  output  will  be 
written  on  the  terminal  when  in  conversational 
mode  and  on  the  line  printer  when  running  batch. 
There  are  several  reasons  why  you  would  want  to 
route  the  outputs  elsewhere,  especially  if  in  on- 
line processing: 

a.  Large  quantities  of  output  would 
take  too  long  to  be  printed  at  the  terminal. 

b.  Depending  on  the  type  of  terminal 
used,  some  portions  of  the  output  may  not  be 
printed  because  of  physical  restrictions  imposed 
by  the  terminal. 

c.  The  handling  of  printout  from  the 
terminal  can  sometimes  be  awkward  and  the  format 
not  asthetically  pleasing. 

d.  No  copy  of  the  output  is  desired. 
(Only  the  PUNCH  file  may  be  needed  as  a step  in  a 
modification  procedure). 

The  following  sections  present  some  alternatives 
available  in  receiving  the  output  from  URA 
commands. 

5.1  Using  the  OUTPUT  Parameter 

The  OUTPUT  parameter  in  the  SET  command  allows 
the  user  to  specify  where  all  output  (except  PUNCH 
information)  generated  by  commands  is  to  be 
printed.  If  nothing  is  specified,  all  output  is 
sent  to  the  terminal.  To  specify  that  output  is 
to  be  sent  elsewhere,  the  URA  SET  command  should 
be  given  as: 
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SET  OUTPUT=dataset-name 


URA  will  then  copy  all  information  into  the 
dataset  which  may  then  be  listed  on  a high  speed 
printer.  If  the  user  then  wishes  to  return  the 
output  to  the  terminal,  he  may  issue: 

SET  OUTPUT=* 

A good  example  of  how  these  parameters  are  used  is 
the  following  sequence  of  URA  commands. 

SET  OUTPUT=OUTPUT. DATA 

NAME-GEN  ALL 

FPS 

NAME-GEN  PROCESS 

PICTURE 

SET  OUTPUT=* 

NAME-GEN  UNDEFINED 
CHANGE-TYPE  TYPE=GROUP 


In  the  above,  four  reports  were  copied  into 
the  dataset  named  OUTPUT. DATA  as  it  is  probable 
that  these  printouts  will  be  fairly  large  and 
would  be  better  printed  on  a high  speed  printer. 
The  output  was  then  sent  back  to  the  terminal  (*) 
so  that  some  editing  might  be  done  on  the  database 
(in  this  case  all  undefined  names  changed  to 
GROUPS) . 

5.2  The  NOPRINT  Parameter 

Several  URA  commands  allow  the  option  of  not 
having  the  output  printed  via  the  NOPRINT 
parameter.  The  commands  that  currently  allow  this 
parameter  are: 


DELFTE-COMMENT- ENTRY  (DCOM) 

PO  RM  ATT  E D- PRO BL  EM- S TAT EMENT  (FPS) 

NAME-GEN  (NG) 

PRINT-COMMENT- ENTRY  (PCOM) 

PROCESS- INPUT -OUTPUT  (PRIO) 

REPLACE-COMMENT-ENTRY  (RCOM) 

The  two  Modifier  Commands  RCOM  and  PCOM  have 
this  parameter  available  because  the  printout  can 
be  fairly  larqe  and  may  not  be  needed  for  future 
reference.  The  report  heading  for  the  RCOM  or 
PCOM  output,  and  any  error  diagnostics  are  still 
printed  to  provide  a hard-copy  record  of  the 
command  implementation. 

The  remaining  four  commands  (which  happen  to 
be  Report  Commands)  can  use  this  parameter  in 
conjunction  with  the  PUNCH  parameter.  When  PUNCH 
1 information  is  desired,  there  may  be  no  need  for 

the  report,  therefore,  the  option  of  the  NOPRINT 
parameter. 
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6.0  Control  Commands 


All  the  commands  in  this  section  relay  control 
information  to  URA.  Each  will  be  described  in  the 
following  format: 

Command  name 

Implementation  - how  to  send  control  information 
to  URA. 

Options  and  Alternatives  - how  to  use  different 
command  parameters  to  specify  different  control 
information. 

Common  Errors  - some  of  the  common  logical  and 
syntactical  errors  that  occur  when  implementing 
this  command. 

Examples  are  provided  for  the  commands  listed  below. 


43 


6.1  Attention  Interrupt 
Implementation 


In  many  cases,  it  is  convenient  to  return  to 
TSO  to  create  and  copy  information  into  datasets 
or  edit  existing  datasets.  When  this  is  the  case, 
the  user  may  get  out  of  URA  by  hitting  the  ATTN  or 
BREAK  key  after  which  TSO  will  first  type  an 
exclamation  mark  (!)  and  after  a brief  delay  will 
type  READY.  After  all  TSO  commands  are  completed, 
it  is  necessary  to  issue  an  EXEC  CLI  to  return  to 
URA  (an  EXEC  UFA  may  also  be  given  but  this  will 
take  much  longer  and  is  unnecessary).  An  example 
of  using  TSO  in  this  manner  is  shown  in  Example 
6.1a. 


READY 
free all 
READY 

edit  i.data  new 
INPUT 

00010  process:  fie ld-check- new; 

00020  part:  new-employee-updating; 

00030  utilized  by:  new-inf or-validation; 

00040  eof 
00050  (RETURN) 

EDIT 

se 


U 


SAVED 


READY 


EXEC  CL  I 

INPUT-URL  1=1. DATA  UPDATE 

Options  and  Alternatives 
None 


Note 


For  sake  of  economy,  the  user  should  enter  a 
FREEALL  upon  receiving  a READY  after  an  Attention 
Interrupt.  This  step  is  not  always  necessary  but 
will  make  the  EXEC  CLI  restart  execute  more 
efficiently. 

6.2  SAVE 

Implementation 

Before  performing  any  modifications  on  the  URA 
database  (via  the  Modifier  commands)  it  may  be 
desirable  to  save  the  contents  of  the  URA  database 
as  a precaution.  If  TSO  crashes  during  a 
modification  procedure  it  is  possible  that  the 
contents  of  the  URA  database  being  modified  will 
become  unusable. 

To  safeguard  against  any  such  disaster,  the 
user  may  wish  to  make  a copy  of  his  database 
before  attempting  any  modification.  This  is 
readily  accomplished  in  TSO  using  the  COPY 
command.  The  user  should  issue: 

COPY  URADB. DATABASE  SAVE. DATABASE 

which  will  cause  TSO  to  create  a compatible 
database  file  and  copy  the  contents  of 
URADB. DATABASE  into  it.  If  the  dataset  being 
copied  into  already  exists,  the  user  will  be 
prompted  with: 


DATASET  SAVE. DATABASE  IS  ABOUT  TO  BE  REUSED 

and  will  then  allow  the  user  to  either  give  the 
command  the  go  ahead  (at  which  time  all  previous 
contents  of  SAVE. DATABASE  will  be  lost)  or 
respecify  the  command.  If  the  dataset  with  the 
name  does  not  exist,  one  will  automatically  be 
created. 

If  no  disaster  occurs,  the  SAVE. DATABASE  may 
be  destroyed  by  issuing 

DELETE  SAVE. DATABASE 

If  a disaster  has  occurred,  the  contents  may 
be  recalled  in  either  of  two  ways.  The  first  and 
least  expensive  is  to  use  the  RENAME  command  after 
deleting  the  unusable  database: 

RENAME  SAVE. DATABASE  UR ADB . DATABASE 

Using  this  method,  the  user  returns  the  database 
to  the  contents  it  was  before  the  disaster  but  no 
longer  has  a copy  of  his  database.  The  user  may 
also  use  the  COPY  command  after  the  unusable 
database  has  been  deleted: 

DELETE  URADB.  DATABASE 

COPY  SAVE. DATABASE  URADB. DATABASE 

If  the  user  no  longer  wishes  a copy  he  may  issue: 

DELETE  SAVE. DATABASE 

and  he  will  be  left  with  his  original  database. 

6.3  SET 

Impl ement at ion 

There  are  so  many  different  possible 
implementations  of  this  command  that  only  the  more 
valuable  ones  will  be  shown.  The  most  common  form 
of  this  command  is  using  OUTPUT  and  DB  parameters: 
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SET  DB=URADE. DATABASE  OUTPUT=OUTPUT. DATA 

The  DB  parameter  specifies  the  database  file  to  be 
accessed  by  subsequent  URA  commands.  OUTPUT  sends 
all  report  data  to  the  specified  dataset.  These 
parameters  retain  their  values  until  the 
parameters  are  reassigned  (via  another  SET 
command)  or  the  URA  run  is  terminated  by  the  STOP 
command  or  an  Attention  Interrupt. 

Options  and  Alternatives 

Another  parameter  which  might  prove  valuable 
is  the  INPUT  parameter.  By  specifying  INPUT: 

SET  INPUT=COMMANDS. DATA 

URA  will  use  the  dataset  for  a source  of  URA 
commands.  This  is  desirable  when  a certain 
sequence  of  commands  are  often  repeated  or  when 
the  system  is  slow  and  the  user  wishes  to  spend 
time  elsewhere.  This  could  be  done  as  follows: 


j 

READY 

FREEALL 

READY 


EDIT  commands. data  nonum  new 
input 

set  db=uradb. dataoase 
ng  all 
f ps 

dictionary 
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ng  prc 


picture 

(blank  line  RETURN) 

EDIT 

se 

SAVED 
READY 
EXEC  CL  I 

SET  I=COMMANDS. DATA 


URA  will  execute  all  the  commands  in  the  file 
COMMANDS . DATA  and  then  return  control  to  the  user. 
COMMANDS . DATA  could  be  kept  for  later  use  if  this 
is  desirable. 

Common  Errors 

It  is  very  important  to  keep  track  of  how  you 
have  set  the  various  parameters.  Most  of  all,  be 
sure  that  you  have  set  DB  equal  to  the  database 
you  want  accessed.  If  this  is  not  set,  it 
defaults  to  DB=URADB. DATABASE  which  may  not  be  the 
database  you  want  to  access. 

6.4  STOP 

I implementation 

This  is  the  easiest  command  to  implement.  By 
specifying: 


you  terminate  the  URA  run  and  return  to  TSO  mode. 
If  it  is  desired  to  return  back  to  URA  after  this 
command  is  issued,  you  must  again  use: 

EXEC  URA 

Also,  all  the  parameters  previously  assigned  by 
the  SET  command  are  reset  to  their  default  values 
every  time  the  EXEC  URA  statement  is  given. 

The  STOP  command  is  used  instead  of  the 
interrupt  in  order  to  delete  a large  number  of 
working  files  created  by  URA.  These  datasets  are 
used  in  processing  URA  Reports  and  should  be 
deleted  as  a space  saving  policy. 

Options  and  Alternatives 


7 . 0 Modifier  Commands 

All  the  commands  in  this  section  modify  the 
URA  database  in  some  manner  and  generate  an  output 
to  present  tne  status  of  the  modification.  Each 
Modifier  command  will  be  described  in  the 
following  format: 

Command  name  - (command  abbreviation) 

Modification  made  - what  change  is  made  in  the 
database  by  this  command. 

Output  description  - presents  such  information  as: 

- Name  of  the  output. 

- Diagnostics  given  by  the  output. 

I mplementation  - how  to  implement  the 
modification. 

Options  and  Alternatives  - what  variations  in 
modifying  the  database  can  be  made  by  usage  of  the 
command  parameters. 

Usage  With  NAME-GEN  - how  to  aid  modifications  to 
the  database  by  using  NAME-GEN  in  conjunction  with 
it. 

Common  errors  - some  of  the  common  logical  and 
syntactical  errors  that  occur  when  implementing 
this  command. 

Examples  are  provided  for  the  commands  listed 
below. 
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7 • 1 CHANGE-TYPE  (CT) 

Modi fi cat ion  Made 

Each  name  specified  as  input  to  this  command 
has  its  corresponding  name  type  changed  if  the  new 
name  type  does  not  conflict  with  the  context  in 
which  the  name  has  previously  been  used.  This 
modification  is  most  often  implemented  to  change 
an  undefined  name  (***UNKNOWN  OR  AMEIGUOUS***)  to 
a specific  name  type  (such  as  GROUP  or  ELEMENT)  . 

Output  Description 

The  output  generated  by  this  command  is  the 
CHANGE-TYPE  REPORT.  For  each  name  used  as  input 
to  the  CHANGE-TYPE  command,  the  name  is  printed 
out  on  the  report  followed  by  some  diagnostics. 

If  the  modification  is  successful,  the  report  will 
specify  the  old  name  type  associated  with  that 
name  and  the  new  name  type  assigned  to  it.  If  the 
modification  is  not  successful,  error  diagnostics 
will  be  given  about  why  the  attempt  failed. 

Implementation 

To  change  the  name  type  of  only  one  name,  the 
following  command  format  is  issued: 

CHANGE-TYPE  NAME=GROSS- PAY  TYPE= ELEMENT 

Previously  in  the  user  requirement,  GROSS- PAY  had 
been  defined  to  be  a GROUP.  As  it  was  more 
appropriate  being  an  ELEMENT,  the  CHANGE-TYPE 
command  made  it  easy  to  facilitate  this  change. 

The  resulting  CHANGE-TYPE  REPORT  is  shown  in 
Example  7.1a. 

Options  and  Alternatives 

It  may  be  desirable  to  change  several  names  at 
once  via  the  FILE  parameter.  If  a number  of  names 
are  to  have  their  types  changed,  this  can  be  done 
as  shown  in  Example  7.1b.  Each  of  the  three  names 
put  info  CHANGE. DATA  were  previously  undefined 
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(not  assigned  a name  type) . The  format  for 
CHANGE. DATA  was  as  below: 

DATE  GROUP 

EMPLOYEE-DATA  GROUP 

VALI D-T-CARD  ELEMENT 

The  format  is  not  important  so  long  as  the  name 
and  its  new  name  type  appear  within  the  first 
eighty  characters  of  the  line  and  at  least  one 
blank  appears  between  them. 

It  is  also  possible  to  change  a list  of  names 
to  the  same  type  by  use  of  the  TYPE  parameter.  In 
this  case  the  names  to  be  changed  to  GROUP  types 
are  listed  in  a dataset.  The  change  type  command 
is  then  given  as  below: 

CT  FILE=CHNG. DATA  TYPE=GROUP 

which  will  cause  all  of  the  names  in  the  file  to 
be  changed  to  GROUP. 

If  the  two  formats  are  mixed,  the  TYPE 
parameter  will  have  precedence  that  is  if  the 
dataset  CHANGE. DATA  shown  above  is  used  with  the 
type  command  the  assigned  types  in  CHANGE. DATA 
will  be  ignored.  For  example,  the  report  in 
Example  7.1c  gives  the  results  of  the  command: 

CT  FILE=CHANGE. DATA  TYPE= ELEMENT 

usage  With  NAME -GEN 

It  can  sometimes  be  a great  advantage  to  use 
NAME-GEN  output  as  input  to  CHANGE-TYPE.  Say,  for 
example,  that  all  the  undefined  names  in  your  user 
requirement  are  really  GROUP  names.  This  change 
can  be  made  in  the  following  manner: 

NAME-GEN  UNDEFINED 

CHANGE-TYPE  FILE  TYPE=GROUP 
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Tne  rxAME-GEN  command  retrieves  all  the  undefined 
nam^s  (specified  by  the  parameter)  and  puts  them 
into  the  file  URANAMES.  Then,  the  CHANGE-TYPE 
command  tax.es  its  input  from  the  file  specified  in 
the  KILE  parameter.  Since  no  file  is  specified, 
it  takes  its  input  from  URANAMES.  The  TYPE=GROUP 
parameter  specifies  that  all  names  in  the  input 
file  for  this  command  be  changed  to  GROUP  names. 
Example  7. Id  shows  that  the  operation  was 
successful. 

Common  Errors 

Probably  the  most  common  error  is  attempting 
to  assign  a name  type  to  a name  that  is  used  in 
another  context.  For  example,  if  we  previously 
stated  that  El  was  CONTAINED  in  SET  SI,  this  would 
imply  that  El  was  an  ENTITY.  Now,  if  we  attempted 
to  change  El's  name  type  to  GROUP,  an  error 
message  would  be  given  notifying  us  that  El  has 
been  used  in  a different  context.  It  is  illegal 
in  URL  to  say  a GROUP  is  contained  in  a SET.  (See 
ESD  TR#  XXXXXXXXXX) , "URL  Users  Manual"  for  the 
complete  set  of  rules  for  using  URL) . 
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Example  7.1b 


Example  7.1c 


CHANGE  - TYPE  REPORT 


7.2  DELETE  (DEL) 


Modification  Made 

For  each  name  specified  as  input  to  the  DELETE 
command,  all  its  relationships  with  other  names  in 
the  database  are  severed  (i.e.,  USES,  SUBPARTS, 
etc.),  its  comment  entries  (such  as  DESCRIPTION  or 
PROCEDURE)  are  deleted  and  finally  the  name  is 
deleted  from  the  database. 

Output  Description 

The  DELETION  REPORT  is  produced  each  time  this 
command  is  initiated.  It  presents  the  status  of 
the  change  for  each  name  used  as  input.  If  the 
change  is  successful,  the  report  will  specify  that 
the  name  is  deleted;  if  not,  it  will  generate 
error  diagnostics. 

Implementation 

To  delete  one  name  from  the  database,  the 
following  command  was  given: 

DELETE  NAME=FI ELD-CHECK-NEW 

This  name  was  deleted  because  the  description  of 
this  PROCESS  is  already  incorporated  within 
another  PROCESS  and  no  longer  necessary.  The 
DELETION  REPORT  for  this  action  is  shown  in 
Example  7.2a. 

As  with  most  other  commands,  it  is  possible  to 
delete  several  names  at  one  time  by  putting  the 
list  of  names  into  a file. 

EDIT  DEL. DATA  NEW  NONUM 

INPUT 

stub 

check 
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fixed-employee- data 
(blank  line  RETURN) 


!■ 

r 

I 


EDIT 


se 

EXEC  CLI 

DELETE  FILE= DEL. DATA 

All  these  names  will  be  deleted  from  the  database 
as  shown  by  Example  7.2b. 

Usage  With  NAME-GEN 

Though  it  is  possible  to  use  NAME-GEN  and 
DELETE  together,  there  is  no  general  case  where 
this  would  commonly  be  done. 

Common  Errors 

Delete  should  not  be  used  to  delete  the  entire 
contents  of  a database.  It  is  much  more 
economical  to  simply  delete  the  database  and 
create  a new  one. 

Another  common  error  that  can  occur  when  doing 
minor  editing  of  the  database  is  to  delete  the 
name  before  saving  the  information  connected  to 
that  name,  what  should  be  done  first  is  a 
FO  RM  ATTE  D- PRO  BL  EM- ST ATEMENT : 

FPS  NAME=name  PUNCH= PUNCH 

DELETE  NAME=name 

At  this  point,  the  old  information  in  PUNCH  can  be 
edited  to  suit  the  user  and  then  re-entered  via 
the  INPUT-URL  command: 

INPUT-URL  UPDATE  INFUT= PUNCH 
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Also,  if  a dataset  is  used  (INPUT=  ) as  input  to 
the  command,  all  names  to  be  deleted  must  begin  in 
the  first  column  of  the  file  line.  Any  preceding 
blanks  will  be  interpreted  as  being  part  of  the 
name. 

[ 


Example  7.2a 


7.3  DELETE -COMMENT-ENTRY  (DCOM) 


Modification  Made 


The  DELETE-COMMENT-ENTRY  takes  those  names  specified  as  input 
and  deletes,  for  each  Input  name,  the  comment  entries  associated 
with  those  comment  entry  types  designated  as  command  parameters.* 
If  no  comment  entry  types  are  specified  by  the  parameters,  no 
conment  entries  will  be  deleted. 

Output  Description 

The  output  report  generated  by  this  command  is  called  DELETED 
COMMENT  ENTRIES.  This  report  gives  a status  listing  of  every 
name  used  as  Input  to  the  command.  This  status  listing  either 
prints  out  each  comment  entry  type  and  corresponding  comment 
entry  that  was  deleted  (for  each  tnput  name)  or  some  error 
diagnostic  to  why  there  was  no  deletton. 

Implementati on 


To  delete  the  PROCEDURE  comment  entries  associated  with  one 
name,  I gave: 

DCOM  N=NEW-INFO-VALIDATION  PRCD 

This  was  done  because  the  current  PROCEDURE  comnent  entry  was  no 
longer  valid  and  there  was  no  replacement.  If  the  comment  entry 
could  be  correct  if  edited  or  a replacement  was  available,  then 
it  would  be  more  appropriate  to  use  the  REPLACE-COMMENT- ENTRY 
command  (see  Section  7.7).  The  output  report  generated  by  this 
command  Is  shown  In  Example  7.3a. 

Options  and  Alternatives 

V. 

1.  Multiple  comment  entries  could  be  deleted  for  a name: 

DCOM  N=NEW-INFO-VALIDATION  PRCD  DESC 

In  this  case,  the  PROCEDURE  and  DESCRIPTION  comment  entries 
would  be  deleted  for  NEW- INFO-VALIDATION. 


* An  example  of  a comment  entry  type  is  a URL  "DESCRIPTION" 
or  "PROCEDURE"  statement.  The  comment  entry  associated  with 
this  comment  entry  type  would  be  the  text  specified  by  the 
user  for  the  particular  statement. 
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2.  Several  names  could  have  a comment  entry  deleted  such  as: 


EDIT  DCOM. DATA  NEW  NONUM 
INPUT 

N EW- EMPLOYE  E- PRI NTI NG 
NEW— I NFO-VALI DAT ION 
(blank  line  RETURN) 

EXEC  CLI 

DCOM  FILE= DCOM. DATA  DESC 


This  would  mean  that  all  the  names  In  the  file,  dcom. data, 
would  have  thetr  DESCRIPTION  comment  entries  deleted. 

3.  Several  names  could  have  multiple  comment  entries  deleted: 


EDIT  DCOM. DATA  NEW 
INPUT 

NEW-EMPLOYEE- PRINTING 
NEW-INFO- VALIDATION 
(blank  line  RETURN) 

EXEC  CLI 

DCOM  FILE= DCOM. DATA  DESC  PRCD 


The  output  report  generated  from  this  command  ts  shown  In 
Example  7.3b.  It  is  not  necessary  that  all  the  names  in 
the  Input-file  have  both  DESCRIPTION  and  PROCEDURE  comment 
entries.  The  comnand  will  delete  only  the  specified  comment 
entries  that  exist  for  each  name.  A message  is  given,  how- 
ever, that  the  comment  entry  did  not  exist  for  the  name. 

Comnon  Errors 

It  is  Important  to  delete  only  those  specific  comment  entries 
that  are  Intended  to  be  deleted. 
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Example  7.3a 
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7.4  DELETE-URL  (PURL) 

Modif icat ion  Made 

This  command  takes  as  input,  any  URL 
statements  in  the  format  specified  in  the  URL 
Users  Manual  (ESD  TR#XXXXXXXXXX) . For  each 
section  header  statement  (i.e.,  PROCESS,  DEFINE, 
etc) , all  the  URL  statements  following  this 
section  header  (up  to  the  next  section  header 
statement)  will  be  deleted  from  the  URA  database 
for  those  names  specified  in  the  header  statement. 
This  command  only  deletes  relationships  between 
names  and  does  not  delete  any  defined  names  from 
the  database:  It  also  does  not  delete  any  comment 

entries  (this  is  handled  by  the  DCOM  command) . If 
some  of  the  information  presented  by  the  URL 
statements  is  contradictory,  an  error  message  will 
be  given  for  that  statement.  Error  diagnostics 
are  also  given  when  syntactical  errors  occur.  URA 
attempts  to  continue  the  procedure  until  too  many 
errors  are  encountered.  (See  Section  9 for  the 
limit  of  errors  allowed) . 

Output  Description 

The  outputs  by  this  command  are  DELETED  URL 
and  the  URA  CROSS  REFERENCE.  The  DELETED  URL 
output  presents  all  the  URL  statements  used  as 
input  into  the  command  exactly  as  they  were 
inputted.  Error  diagnostics  are  also  produced  at 
appropriate  points  in  the  output.  These  aid  in 
correcting  any  errors  that  occur. 

The  URA  CROSS  REFERENCE  is  an  index  to  the 
DELETED  URL.  It  is  only  produced  at  request 
(i.e.,  by  specifying  XREF  as  a command  parameter) 
and  produces  an  alphabetical  listing  of  all  names 
used  in  the  DELETED  URL  output,  their 
corresponding  name  types,  and  the  line  numbers  in 
DELETED  URL  where  each  name  can  be  referenced. 

Implementation 
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The  most  common  method  of  deleting  URL 
statements  is  by  first  writing  all  statements  to 
be  deleted  into  a dataset  and  then  using  this  file 
as  input  to  the  command  via  the  INPUT  parameter. 

EDIT  DEL. DATA  NONUM  NEW 

INPUT 

group  check; 

contained  pay- statement; 
relation  comp-pay-info; 
syn  comp-pay-info; 
element  payrate; 

attr  type  numberic- information; 
values  3 thru  100; 


eof 

(blank  line  RETURN) 

EDIT 

se 

EXEC  CLI 

DELETE-URL  I=DEL. DATA 

The  I=DEL. DATA  specifies  that  the  input  to  this 
command  should  be  read  from  the  dataset  DEL. DATA. 
Example  7.4a  presents  the  DELETED  URL  output  for 
this  procedure. 

Options  and  Alternatives 

1.  In  many  cases  when  the  amount  of  input  is 
relatively  large  (say,  a few  hundred  lines)  there 
may  be  a need  for  the  URA  CROSS  REFERENCE.  By 
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specifying  the  XREF  parameter  with  the  command,  it 
will  be  generated. 

2.  If  no  input  dataset  is  given,  URA  will 
wait  for  URL  statements  from  the  terminal.  In 
this  manner,  most  errors  occurring  in  the  input 
procedure  may  be  corrected  interactively.  Each 
line  entered  by  the  user  is  echoed  back  along  with 
any  diagnostics  for  errors  which  have  been 
encountered  within  the  previously  entered  line. 
This  method  of  inputting  information  is  useful 
from  the  error  correcting  standpoint,  but  is 
hardly  feasible  if  there  are  hundreds  or  thousands 
of  input  lines. 

Common  Errors 

The  most  common  errors  are  typing  errors.  A 
typing  mistake  can  cause  many  different  types  of 
syntactical  and  semantic  errors. 

Only  the  first  72  columns  of  each  line  in  the 
input  file  are  read  so  all  URL  statements  should 
fit  in  this  region.  Anything  over  72  will  be 
truncated  and  an  error  message  will  be  generated 
in  most  cases. 

Omitting  the  semicolon  at  the  end  of  a URL 
statement  is  a common  cause  for  several  errors. 

DELETE-URL  will  not  delete  comment  entry 
statements  from  the  database  so  these  statements 
are  ignored  if  encountered  in  the  input  file. 

Names  cannot  be  deleted  from  the  database  either. 
Only  SYNONYMS  for  names  can  be  deleted. 

The  last  line  of  the  input  file  containing  the 
URL  statements  should  have  the  word  EOF  signifying 
the  end  of  input.  This  should  also  be  typed  when 
inputting  the  data  interactively.  EOF  allows  the 
return  to  the  URA  command  handler.  (See  Example 
6.4a  to  see  how  EOF  is  used  correctly).  No  URL 
statements  are  read  after  EOF. 
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Example  7.4a 


7.5  INPUT-URL  (IP) 

Modification  Made 

This  command  takes  as  input,  any  URL 
statements  in  the  format  specified  in  the  URL 
Users  Manual  (ESD  TR  #XXXXXXXXXX)  . For  each 
section  header  statement  (i.e.,  PROCESS,  DEFINE, 
etc.)  the  user  defined  name  specified  by  that 
section  header  will  be  added  to  the  list  of  names 
in  the  database  (if  not  in  already) . All  the  URL 
statements  following  this  section  header,  up  to 
the  next  section  header  statement,  specify 
connections  to  be  made  with  other  names  in  the 
database.  If  some  of  the  information  presented  by 
the  URL  statements  is  contradictory,  an  error 
message  will  be  given  for  that  statement.  Error 
diagnostics  are  also  given  when  syntactical  errors 
occur.  URA  attempts  to  continue  the  input 
procedure  until  too  many  errors  are  encountered. 
(See  Section  9 for  the  limit  of  errors  allowed) . 

Output  Description 

The  outputs  generated  by  this  command  are  the 
URA  AS-IS  SOURCE  LISTING  and  the  URA  CROSS 
REFERENCE. 

The  URA  AS-IS  SOURCE  LISTING  presents  all  the 
URL  statements  used  as  input  into  the  command 
exactly  as  they  were  inputted.  Error  diagnostics 
are  also  produced  at  appropriate  points  in  the 
LISTING.  These  aid  in  correcting  any  errors  that 
occur. 

The  URA  CROSS  REFERENCE  is  an  index  into  the 
URA  AS-IS  SOURCE  LISTING.  It  is  only  produced  at 
request  (i.e.,  by  specifying  XREF  as  a command 
parameter)  and  produces  an  alphabetical  listing  of 
all  names  used  in  the  AS-IS  LISTING,  their 
corresponding  name  types  (explicitly  or  implicitly 
defined)  and  the  line  numbers  in  the  AS-IS  LISTING 
each  name  can  be  referenced. 

Implementation 
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The  most  common  method  of  inputting  URL 
statements  is  by  first  creating  a data  set, 
writing  all  URL  statements  into  this  dataset  and 
then  using  this  dataset  as  an  input  via  the  INPUT 
parameter.  For  example, 

EDIT  INP . DATA  NONUM  NEW 

INPUT 

process  field-check-new; 

part  of:  new-employee-updating; 

utilized  by:  new- inf o- validation; 


eof 

(blank  line  RETURN) 

EDIT 

se 

EXEC  CLI 

INPUT-URL  I = INP. DAT A UPDATE 

The  UPDATE  parameter  specifies  that  the  URA 
database  is  to  be  modified  by  the  input.  If  this 
parameter  is  not  given  the  information  contained 
in  INP. DATA  will  be  semantically  and  syntactically 
checked  against  the  URA  database  but  will  not 
change  the  database.  Example  7.5a  presents  the 
AS— IS  LISTING  for  this  procedure. 

Options  and  Alternatives 

1.  In  many  cases,  when  the  amount  of  input 
is  relatively  large  (say,  a few  hundred  lines) 
there  may  be  a need  for  the  CROSS  REFERENCE.  By 
simply  specifying,  XREF,  as  a parameter  it  will  be 
generated.  Example  7.5b  presents  an  AS-IS  LISTING 
and  CROSS  REFERENCE  for  a small  problem  statement. 
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2.  In  most  cases,  it  is  advantageous  to 
first  do  a syntax  and  semantic  check  of  the  input 
data  before  you  attempt  to  put  it  in  the  database. 
By  not  specifying  UPDATE,  these  checks  will  be 
made  without  actually  putting  the  information  into 
the  database.  The  command: 

INPUT-URL  I =INP. DATA 

will  generate  as  AS-IS  LISTING  with  error 
diagnostics  for  the  information  in  the  dataset. 
Since  most  problem  statements  have  one  or  two 
typing  errors  anyway,  this  proves  to  be  an 
inexpensive  way  to  catch  errors  early.  After  the 
source  of  the  errors  has  been  determined  and 
corrected,  the  command  can  be  called  again  using 
UPDATE  as  a parameter. 

3.  If  no  input  dataset  is  given,  URA  will 
wait  for  URL  statements  from  the  terminal.  In 
this  manner,  most  errors  occurring  in  the  input 
procedure  may  be  corrected  interactively.  Each 
line  entered  by  the  user  is  echoed  back  along  with 
any  diagnostics  for  errors  which  have  been 
encountered  within  the  previously  entered  line. 
This  method  of  inputting  information  is  useful 
from  the  error  correcting  standpoint,  but  is 
hardly  feasible  if  there  are  hundreds  or  thousands 
of  input  lines. 

Common  Errors 

The  most  common  errors  are  typing  errors.  A 
typing  mistake  can  cause  so  many  different  types 
of  syntactical  and  semantic  errors  that  it  will  be 
handled  in  a later  section  (Section  10) . 

Inputting  the  new  information  into  the  wrong 
database  also  often  happens.  Be  sure  to:  SET 

DB=dbname. database  when  entering  URA  mode.  If 
this  is  not  done,  the  data  base  will  be  set  to: 
DB=URADB. DATABASE  which  may  or  may  not  be  the 
database  you  want  to  access. 
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The  INPUT-URL  command  only  reads  the  first  72 
columns  of  each  line  in  the  input  file  so  all  URL 
statements  must  fit  in  this  region.  Anything  over 
72  will  be  truncated  and  an  error  message  will  be 
given  in  most  cases. 

Omitting  the  semicolon  at  the  end  of  a URL 
statement  is  a common  cause  for  several  errors. 

The  last  line  of  the  input  file  containing  the 
URL  statements  should  have  the  word  EOF  signifying 
the  end  of  input.  This  should  also  be  typed  when 
inputting  the  data  interactively.  EOF  allows  the 
return  to  the  URA  command  handler.  (See  Examples 
7.5a  and  7.5b  to  see  how  EOF  is  used  correctly). 

No  URL  statements  are  read  after  EOF. 


j 
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Example  7.5a 
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7.6  RENAME  (REN) 


Modification  Made 

_ The  RENAME  command  takes  an  old  name  (of  some  object  in  the 

problem  deftneds  data  base)  and  a new  name  as  Input.  If  the 
new  name  ts  not  a URL  reserved  word  or  a name  already  in  the 
data  base,  the  cormand  wtll  replace  the  old  name  by  the  new 
name. 

Output  Description 

The  output  generated  from  this  command  is  called  the  RENAME 
REPORT.  If  the  change  is  successful , the  old  name  and  new 
name  are  printed  under  their  respective  report  headings.  If 
an  error  is  encountered,  error  diagnostics  will  be  given  for 
that  particular  old  name-new  name  pair. 

Implementation 

To  change  one  name  in  the  data  base,  the  following  command 
was  given: 

RENAME  0LD=EMPL0YEE-C0DE  NEW=EMPLOYEE-NUMBER 

Upon  first  defining  the  parget  system,  EMPLOYEE-CODE  was  used  to 
represent  a certain  piece  of  data.  Later  it  was  found  that  this 
data  was  actually  called  EMPLOYEE-NUMBER  and  made  the  change  to 
be  consistent  with  organizational  terminology.  See  Example  7.6a 
for  the  report  generated  by  this  command.  This  command  is  also 
beneficial  for  changing  mispelled  names  in  the  data  base.  Through 
typing  errors,  EMPL0YEE-NUM3ER  may  have  gone  in  as  EMPLYEE- 
NUBER.  This  mistake  can  be  corrected  by: 

RENAME  OLD=EMPLYEE  NUBER  NEW=EMPLOYEE-NUMBER 

Options  and  Alternatives 

As  with  most  of  the  modifier  commands,  the  problem  definer  has 
the  option  of  changing  several  names  at  one  time.  The  old  name- 
new  name  pairs  must  first  be  put  in  a file  to  be  used  as  input  to 
the  command.  The  procedure  could  be  done  like  this: 

EDIT  REN. DATA  NONUM  NEW 
INPUT 

JOSEPH-SMITH  HENRY-MILLER 

VARYING-EMPLOYEE-DATA  CHANGING- EMPLOY EE- DATA 
LEVEL- 1 LI 

ERROR-LISTING  ERROR  LIST 
(blank  line  RETURN) 

EDIT 
SE 

EXEC  CL I 

RENAME  INPUT=REN. DATA 

The  output  of  this  procedure  is  shown  in  Example 
7.6b. 
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The  oldjiame  Is  specified  first  on  each  line,  followed  oy  its  new 
name,  rree  format  allows  the  two  names  to  be  anywhere  in  the  first 
eighty  columns  of  the  file  line  as  long  as  the  old  name  comes  first 
and  che  two  names  are  separated  by  at  least  one  blank. 


The  two  conmands  could  not  be  used  together  directly.  Additional 
preparation  would  be  needed,  discussion  of  which  is  beyond  the 
schope  of  this  paper. 


Common  Errors 


The  most  common  error  in  using  RENAME  Is  specifying  a name  already 
In  the  data  base  or  a URL  reserved  word  as  the  new  name.  ijRA 
will  not  make  the  change  if  this  is  the  case.  The  command  wculd 
have  to  be  reissued  with  another  new  name  to  take  the  place  of 
the  illegal  one. 
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Example  7.6b 


7.7  REPLACE-COMMENT -ENTRY  (RCOM) 


Modification  Made 

This  command  takes  as  tnput,  names  whtch  exist  In  the  data  base, 
each  followed  by  a URL  comment  entry  statement.  If  the  corrment 
Is  a DESCRIPTION  conment  entry,  for  example,  then  the  conmand 
wtll  replace  the  old  DESCRIPTION  comment  entry  by  the  one  used 
as  tnput.  If  there  ts  no  old  DESCRIPTION  to  replace,  the  new 
one  wtll  sttll  be  gtven  to  the  name  and  a warning  will  be  gener- 
ated on  the  output  report. 

Output  Description 

The  output  generated  by  this  report  Is  called  REPLACED  COMMENT 
ENTRIES.  For  each  name-comment  entry  statement  pair  the  report 
prints  out  the  name,  the  comment  entry  in  the  data  base  which 
has  been  deleted  and  the  comment  entry  which  replaces  it. 

Implementati on 

l 

To  change  a couple  of  conment  entries  associated  with  a particular 
name,  the  information  must  first  be  put  into  a file: 

EDIT  RCM . DATA  NONUM  NEW 
INPUT 

NEW- EMPLOYEE- PRINTING 
I DESC; 

This  PROCESS  PRODUCES  THE  NEW  HIRE  SECTION  OF 
THE  H-T  REPORT. 

NEW-EMPLOYEE- PRINTING 
PRCD: 

1)  ACCEPT  A VALID  UNIT  OF  NEW  EMPLOYEE  INFORMATION 

2)  SAVE  THE  INFORMATION 

3)  PRINT  THE  NEW  HIRE  SECTION  OF  THE  H-T  REPORT. 

(blank  line  RETURN) 

SE 

EXEC  CLI 

RCOM  I = RCM. DATA 

Doing  this  results  in  giving  NEW-EMPLOYEE-PRINTING  new  DESCRIPTION 
and  PROCEDURE  comment  entries.  This  was  done  because  the  pre- 
vious DESCRIPTION  was  inaccurate  and  the  PROCEDURE  was  not  complete. 
The  output  generated  by  this  procedure  is  shown  by  Example  7.7a. 

Options  and  Alternatives 

It  Is  often  the  case  that  only  some  minor  editing  of  a comment 
entry  need  be  done  to  make  it  correct.  This  editing  can  be  done 
easily  by  the  following  sequence  of  conmands: 


m 


PCOM  N-NEW- EMPLOYEE-PR I NT  I NG  DESC  P-PUNCH 

f 

EDIT  PUNCH 

CHANGE  3 /ADDS  INFORMATION  TO/PRODUCES  THE  NEW  HIRE  SECTION  OF/ 
SE 

EXEC  CLI 
rCOM  I -PUNCH 


Thts  method  of  replactng  comment  entries  saves  a lot  of  typing 
effort,  especially  when  the  comment  entries  are  lengthy. 

Common  Errors 

The  major  problem  in  using  this  command  is  specifying  the  file 
format  correctly.  It  follows  the  pattern: 

name 

comment  entry  type; 

comment  entry 
• • 

t 

name 

comment  entry  type; 
comment  entry 

*•—  • • 

$ENDFILE 

The  correct  format  is  also  shown  in  the  example  on  the  previous 
page. 

Though  the  command  allows  free  formatting  of  the  file,  the  order: 
name,  comment-entry  type,  and  comment  entry  must  be  maintained. 
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Example  7.7a 


8.  Report  Commands 

All  the  conroands  in  this  section  generate  reports  and  vill  be 
described  in  the  following  format: 

Command  name  (conmand  abbreviation) 

Report  Description*  - presents  such  information  as: 

- Name  of  the  report(s)  generated  by  this 
command. 

- The  different  URL  name  types  this  report 
can  be  produced  for. 

- What  Information  is  generated  for  each  name 
type  and  name  in  the  URA  data  base. 

Implementation  - how  to  obtain  the  basic  report. 

Options  and  Alternatives  - what  variations  in  format  and  content 

of  the  output  report  can  be  obtained 
through  usage  of  the  command  parameters. 

Usage  with  NAME-GEN  - how  to  aid  report  production  by  using  the 

NAME-GEN  conmand  in  conjunction  with  it. 

Common  Errors  - some  of  the  common  logical  and  syntactical 

errors  that  occur  when  implementing  this  command. 

Exampl  es 

i 


; 


l 


♦For  a more  detailed  description  of  the  reports  generated  by 
these  commands,  see  part  DT  ,»ura  OUTPUTS"  * 
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8.1  CONSISTS-COMPARISON  (CNC) 

. 

Report  Description 

The  CONSISTS  COMPARISON  REPORT  is  generated  by  this  conmand. 

This  report  retrieves  structure  information  about  the  data 
objects  (SETS,  INPUTS,  OUTPUTS,  ENTITIES  and/or  GROUPS)  used 
as  input  to  the  command.  For  each  input  name,  the  command 
derives  its  lowest  level  constituents  (other  data  names)  via 
the  CONSISTS  statement  relationships  specified  in  the  data  base. 

A matrix  is  used  to  present  this  information.  The  names  used  as 
input  to  the  command  are  represented  by  the  rows  of  the  matrix 
and  the  low  level  constituents,  by  the  columns.  A count  of  the 
constituents  for  each  input  name  and  the  number  of  constituents 
in  conmon  between  any  two  input  names  is  presented  in  a 
second  matrix.  In  this  matrix,  each  input  name  is  represented 
by  a column  and  row. 

Implementation 

The  most  common  form  of  implementing  this  command  is: 

NG  ENTITY  GROUP 
CNC 

This  produces  the  report  shown  by  Example  8.1a.  NAME-GEN  is 
first  used  to  retrieve  all  GROUP  and  ENTITY  names  in  the  data 
base.  "CNC"  is  then  specified  and  so  the  names  retrieved  by 
NAME-GEN  are  used  as  input  to  the  command. 

Options  and  Alternatives 

The  only  parameter  available  for  this  command  is  the  "FILE" 
parameter  which  can  be  used  in  the  following  manner: 

] 

EDIT  CNC. DATA  NONUM  NEW 
F-DATA 
V-DATA 

(blank  line  RETURN) 

SE 

EXEC  CLI 

CNC  F=  CNC. DATA 


which  will  generate  the  report  for  only  these  two  names.  Since 
the  report  is  rather  large,  anyway,  and  relatively  expensive  to 
generate,  it  is  best  to  have  the  report  generated  for  several 
names  (using  NAME-GEN)  at  one  time. 

Usage  With  NAME-GEN 

(See  the  example  specified  above.) 

Conmon  Errors 

It  must  be  kept  in  mind  that  only  data  object  names  (SETS,  INPUTS, 
OUTPUTS,  ENTITIES  and  GROUPS)  can  be  used  as  input  to  the  command. 
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Example  8.1a  (cont'd) 


T 


8.2  CONSISTS-MATRIX  (CM) 

Report  Description 

This  command  produces  the  CONSISTS  MATRIX  REPORT.  The  report 
consists  of  a matrix  where  the  names  represented  by  the  rows 
are  CONTAINED  in  the  names  represented  by  the  columns  through 
CONSISTS/CONTAINED  relationships  specified  in  the  data  base. 

The  existence  of  such  a relationship  is  specified  by  an  asterisk. 

A summary  is  also  produced  which  aids  in  describing  the  informa- 
tion portrayed  in  the  matrix. 

Implementations 

The  basic  form  of  the  report  can  be  obtained  by: 

CM  N=EMPLOYEE-NUMBER  CNTD 

This  particular  command  format  retrieves  all  these  data  objects 
which  contain  EMPLOYEE-NUMBER.  Whenever  using  the  CONTAINED 
parameter  (CNTD),  all  the  names  used  as  input  to  the  command  must 
be  ELEMENT,  GROUP,  INPUT,  OUTPUT  and/or  ENTITY  names.  The  informa- 
tion presented  for  EMPLOYEE-NUMBER  is  retrieved  from  the  data  base 
in  the  opposite  direction  as  is  the  Information  presented  in  the 
CONTENTS  REPORT. 

E 

i Options  and  Alternatives 

| 

- A more  commonly  used  form  of  the  report  can  be  obtained  by  using 

the  "FILE"and  "CONSITS"  parameters: 


1 


This  produces  the  same  information  as  presented  In  the  CONTENTS 
REPORT  (using  the  LEVELS—!  parameter),  but  in  a matrix  format. 
The  report  generated  by  this  procedure  is  shown  in  Example  8.2a. 

When  using  the  CONSISTS  parameter,  only  SET,  INPUT,  OUTPUT, 
ENTITY  and  GROUP  names  may  be  used  as  input  to  the  command. 

Usage  With  NAME-GEN 

It  is  usually  easiest  to  use  the  NAME-GEN  command  with  CM  to 
generate  a report: 

NG  SET  ENTITY  GROUP 
1 _ CM  CSTS 


EDIT  CM. DATA  NONUM  NEW 
EXPLICIT-PESONAL-DATA 
EMPLOYEE-NAME 
TERMINATED- EMPLOYEE- PART 
(blank  line  RETURN) 

SE 

EXEC  CLI 

CM  F=CM. DATA  CSTS 
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This  sequence  produces  a matrix  with  all  SET,  ENTITY  ari 
GROUP  names  In  the  data  base  representing  the  columns  c F the 
matrix.  The  report  produced  by  this  is  shown  in  Exampl 2 8.2b. 

Common  Errors 

What  is  most  Important  is  that  only  the  proper  types  of  data 
names  (SETS,  etc.)  are  used  with  the  proper  parameter  (CONSISTS 
or  CONTAINED). 
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Example  J$.2b  (cont'd) 


8.3  CONTENTS  (CONT) 

Report  Description 

The  CONTENTS  REPORT  is  generated  by  this  command.  It  presents  the 
data  structure  specified  through  usage  of  the  CONSISTS  statement 
in  the  problem  statement.  For  this  reason,  only  SET,  INPUT,  OUTPUT, 
ENTITY  and  GROUP  names  may  be  used  as  input  to  the  command.  All 
names  used  as  input  to  the  command  are  designated  as  level  1 data 
objects  (in  the  report)  and  each  subordinate  level  is  identified 
by  a level  number  and  the  names  of  all  data  objects  in  that  level. 
The  lower  levels  will  consist  of  INPUT,  OUTPUT,  ENTITY,  GROUP  and 
ELEMENT  names. 

Implementation 

To  obtain  the  basic  report  for  one  data  object,  specify: 

CONTENTS  N=VARYING-EMPLOYEE-DATA 

This  is  a simple  way  of  finding  out  all  the  data  which  is  contained 
within  this  one  object.  If  the  data  structure  represented  by  the 
report  is  not  satisfactory,  more  information  (in  the  form  of  URL 
statements)  may  have  to  be  added  to  make  it  "complete."  It  must 
be  remembered  that  only  subordinate  levels  are  presented  and  any 
levels  above  VARYING-EMPLOYEE-DATA  (it  may  be  contained  in  a SET) 
are  not  shown.  The  output  generated  by  this  statement  is  shown  in 
Example  8.3a. 

Options  and  Alternatives 

This  report  can  be  obtained  for  several  names  at  one  time  by  using 
the  FILE  parameter: 

r 

EDIT  CONT. DATA  NONUM  NEW 
NEW- EMPLOYEE- INFORMATION 
PAY-STATEMENT 
PAYSYSTEM-OUTPUTS 
TIME-CARD 

(blank  line  RETURN) 

SE 

EXEC  CL I 

CONTENTS  FILE=CONT. DATA 


The  results  of  this  proceudre  are  shown  in  Example  8.3b.  The 
asterisk  (*)  designates  the  name  as  being  one  of  the  input  names 
to  the  comnand.  The  numbers  beneath  the  asterisk  specify  the 
number  of  subordinate  data  objects  (with  respect  to  the  level  1 
object)  in  the  order  they  were  retrieved  from  the  data  base  to 
be  printed.  Note  that  PAYSYSTEM-OUTPUTS  has  no  subordinate  objects 
(or  at  least  none  via  the  CONSISTS  statement).  It  is  possible 
that  a structure  may  be  specified  by  use  of  the  SUBPARTS  statement, 
also.  (See  the  STRUCTURE  command.  Section  8.17.) 
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The  rumber  of  subordinate  levels  to  be  printed  for  each  name  may 
be  controlled  via  the  LEVELS  parameter.  If  LEVELS=2  we  e also 
giver  in  the  above  example  for  CONTENTS,  only  the  level  1 and 
level  2 names  would  appear  on  the  report.  It  is  wise  to  utilize 
this  parameter  when  you  have  described  a large  data  stricture  in 
the  problem  statement  and  it  is  difficult  to  estimate  wi.at  the 
size  of  the  resulting  output  will  be  when  a CONTENTS  cormand  is 
used. 

When  the  output  is  thought  to  be  large,  however,  it  is  usually  a 
good  idea  to  also  specify  the  INDEX  parameter  to  generate  an  index 
into  the  report. 

The  command  can  also  perform  some  "completeness"  checks  on  the 
information  presented  in  the  report  by  specifying  the  NCFLA6 
parameter.  This  results  in  having  all  undefined  data  objects 
(those  whose  name  type  is  ***  UNKNOWN  or  AMBIGUOUS  ***  flagged 
and  any  GROUPS  which  do  not  consist  of  any  lower  level  data  objects 
flagged.  (By  logical  definition,  a group  consists  of  one  or  more 
objects. ) 

Usage  With  NAME-GEN 

NAME-GEN  is  very  often  used  in  conjunction  with  the  CONTENTS  command 

NAME-GEN  SET 
CONTENTS 

This  sequence  of  URA  command  produces  a listing  of  all  SET  names 
in  the  URA.  data  base  (via  the  NAME-GEN  command)  and  then  produces 
a CONTENTS  REPORT  using  each  SET  name  as  a level  1 data  object. 

This  should  give  you  a fairly  complete  representation  of  your 
problem  statement's  data  structure. 

Corrmon  Errors 


Care  must  be  taken  that  only  SET,  INPUT,  OUTPUT,  ENTITY  and  GROUP 
names  are  used  as  input  to  this  command.  Any  other  name  types  will 
not  be  allowed.  (ELEMENT  can  not  be  given  because  an  ELEMENT  can 
not  CONSIST  of  any  subordinate  data  objects  by  URL/URA  definition.) 

Cases  have  occurred  where  an  excessively  large  output  has  been 
produced  because  the  problem  definers  were  unable  to  estimate 
the  size  of  the  data  structure  they  had  specified.  Constantly 
keep  this  in  mind,  and  when  in  doubt  produce  the  output  a level 
at  a time  via  the  LEVELS  parameter. 
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Example  8.3b 


Jr 


DATA-BASE-STATISTICS  (DBS) 


Report  Description 

This  command  generates  the  DATA  BASE  STATISTICS  report.  It 
presents  all  names  defined  in  the  URA  data  base  along  with 
information  related  to  the  physical  URA  data  base.  This  infor- 
mation is  of  relatively  little  interest  to  the  user. 

This  report  is  intended  for  those  people  implementing  and 
maintaining  the  URA  software  at  their  computer  installation. 

Implementation 

To  generate  the  basic  report: 

DBS 

will  produce  the  printout  shown  in  Example  8.4. 

Options  and  Alternatives 

Additional  information  may  be  added  to  the  report  by  specifying 
SYNONYM  and  NAMNUBS  as  parameters  for  the  DBS  conmand. 

Usage  with  NAME-GEN 

This  report  cannot  be  used  with  NAME-GEN. 

Common  Errors 

Since  this  command  is  not  intended  for  use  by  the  user 
(It  does  not  directly  help  him  in  defining  a user  requirement  ), 
the  output  should  be  generated  only  for  those  persons  that  know 
how  to  Interpret  the  Information  on  it. 
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EXAMPLE  0.4  (coat'd) 


8.5  DATA -PROCESS  (DP) 

Report  Description 

The  DATA  PROCESS  REPORT  is  produced  by  this  conmand.  Two 
matrices  are  presented  that  provide  information  about  PROCESSES 
and  data  objects  (SETS,  INPUTS,  OUTPUTS,  ENTITIES,  GROUPS  and 
ELEMENTS).  The  first  matrix  describes  the  interaction  oetween 
data  objects  and  PROCESSES  (that  data  which  USES,  RECEIVED, 
GENERATED,  DERIVED  or  UPDATED  for  a particular  PROCESS).  The 
data  objects  are  represented  by  the  rows  and  the  PROCESSES  by  the 
colunns.  The  type  of  relation  is  determined  by  the  entry  in  the 
matrix.  The  second  matrix  describes  the  data  transfer  between 
PROCESSES.  In  this  matrix,  PROCESS  names  represented  by  rows 
DERIVE  an  UPDATE  data  which  is  USED  by  PROCESS  names  represented 
by  columns.  The  existence  of  such  a relationship  is  specified  by 
an  asterisk  (*). 

Implementation 

One  simple  form  of  this  report  can  be  obtained  In  the  following 
manner: 

DP  N=PAYROLL-PROCESSING  PROCESS 

This  would  present  all  the  data  that  interacts  with  the  PROCESS 
"PAYROLL-PROCESSING"  in  a matrix  format.  The  second  matrix  would 
not  be  produced,  however.  See  Example  8.5a  for  the  printout 
generated  by  this  command. 

Options  and  Alternatives 

The  user  may  use  the  FILE  parameter  to  specify  input: 

EDIT  DP. DATA  NONUM  NEW 

F-DATA 

V-DATA 

(blank  line  RETURN) 

SE 

EXEC  CLI 

DP  F= DP. DATA  DATA 

By  usage  of  the  DATA  parameter,  the  command  retrieves  all 
PROCESSES  which  Interact  with  the  names  specified  In  the  input 
file.  Note  here  that  when  the  DATA  parameter  is  given,  all 
names  used  as  input  must  be  data  object  names  (i.e.,  SET,  INPUT, 
OUTPUT,  ENTITY,  GROUP  and/or  ELEMENT  names). 

Whenever  the  PROCESS  parameter  is  used,  all  the  names  used  as 
Input  to  the  command  must  be  PROCESS  names. 

Usage  With  NAME-GEN 

The  most  common  method  of  using  this  command  is  as  follows: 
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NG  PROCESS 
DP  PROCESS 


This  produces  the  report  using  all  PROCESS  names  defined  in  the 
data  base.  Example  8.5b  presents  an  example  of  this  implementation. 

Common  Errors 

The  user  must  keep  in  mind  which  types  of  names  are  allowed  for  the 
PROCESS  and  DATA  parameters. 

This  report  proves  to  be  more  valuable  (in  most  cases)  when 
generated  for  several  input  names.  This  command  is  relatively 
costly  to  implement  and  produces  a large  amount  of  output. 

The  matrices  can  be  very  large  and  sparse,  so  this  command  should 
only  be  used  when  many  processes  are  completely  defined. 
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DATA  PROCESS  REPORT 
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Example  8.5a  (cont'd) 
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Example  8.5b  (cont'd) 


Example  8.5b  (cont'd) 
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Example  8.5b  (cont'd) 


8.6  DICTIONARY  (DICT) 

Report  Description 

The  output  from  this  command  is  called  the  DICTIONARY  REPORT. 
For  each  name  used  as  input  to  the  command  the  report  presents 
description  and  identification  information.  Any  type  of  name 
(ATTRIBUTE,  PROCESS,  MAILBOX,  etc.)  may  have  this  information 
presented  by  the  DICTIONARY  REPORT.  More  specifically,  this 
Information  is  derived  from  the  DESCRIPTION,  SYNONYM,  KEYWORDS 
and  RESPONSIBLE-PD  statements  in  the  URA  data  base  for  each  of 
the  names  used  as  input.  Its  name  type  is  also  presented  as 
part  of  the  identification  information. 

Imp! ementation 

To  produce  the  DICTIONARY  REPORT  for  one  name  only,  specify: 

DICTIONARY  N=PAYROLL-PROCESSING 

The  output  produced  from  this  command  is  shown  in  Example  8.6a. 
Even  if  some  of  the  description  or  identification  information 
that  is  to  be  retrieved  by  this  command  has  not  been  specified 
for  this  name,  the  information  that  has  been  specified  will  be 
presented. 

Options  and  Alternatives 


Any  of  the  information  retrieved  for  this  report  (DESCRIPTION, 
KEYWORDS,  etc.)  can  be  omitted  by  prefixing  the  parameter  with 
"NO."  For  example, 

DICT  N=PAYR0LL- PROCESSING  NODESCRIPTION 

would  present  the  same  information  as  shown  in  Example  8.6a,  but 
without  the  DESCRIPTION  statement. 

The  report  may  be  generated  for  several  names  by  using  the  FILE 
parameter: 

EDIT  DICT. DATA  NONUM  NEW 

CHECK 

STUB 

(blank  line  RETURN) 

SE 

EXEC  CLI 

DICT  FILE=DICT. DATA  i 

In  which  the  report  would  be  generated  for  the  two  names, 

CHECK  and  STUB.  When  the  report  is  being  produced  for  several 
names,  the  user  may  make  the  printout  more  readable 

by  assigning  the  NUM-SPACE  parameter  with  some  value  larger 
than  2.  This  parameter  determines  the  number  of  spaces  to  be 
inserted  between  any  two  entries  on  the  output. 


Usage  with  NAME-GEN 


It  is  a trivial  matter  to  generate  a "complete"  data  dictionary 
when  the  DICTIONARY  conmand  is  used  together  with  NAMF-GEN: 

NG  GROUP  ELEMENT 
DICTIONARY 

This  sequence  produces  the  DICTIONARY  report  for  all  GROUP  and 
ELEMENT  names  that  have  been  defined  in  the  user  requirement  , 
which  proves  to  be  an  excellent  reference  in  later  work. 

The  DICTIONARY  REPORT  can  be  generated  for  all  types  of  names  so 

NG  RUE  PROCESS 
01 CT 

produces  a report  for  all  REAL-WORLD-ENTITY  and  PROCESS  names 
defined  (as  shown  by  Example  8.6b). 

Common  Errors 


Usually,  nothing  more  serious  than  syntax  errors  are  encountered 
when  attempting  to  use  this  command. 
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8.7  ENTITY-IDENTIFIER  (El) 

Report  Description 

The  IDENTIFIER  INFORMATION  REPORT  is  generated  by  this  command. 

~~  It  presents  a matrix  where  IDENTIFIER  names  are  represer ted  by 

the  rows  in  the  matrix  and  ENTITIES  by  the  columns.  The  existence 
of  an  IDENTIFIES  relationship  between  IDENTIFIER  and  ENTITY  is 
specified  by  an  asterisk.  A summary  is  also  produced  to  aid  in 
describing  the  information  portrayed  in  the  matrix. 

Implt mentation 

One  simple  form  of  this  command  is  to  retrieve  all  the  ENTITIES 
that  a particular  IDENTIFIER  "IDENTIFIES": 

El  N* EMPLOYEE-NUMBER  I 

Whenever  the  "I"  (IDENTIFIER)  parameter  is  used,  all  names  used  as 
Input  to  the  command  must  be  IDENTIFIER  names: 

Options  and  Alternatives: 

To  generate  the  report  for  several  names,  the  "FILE"  parameter 
can  be  used: 

EDIT  El. DATA  NONUM  NEW 

F-DATA 

V-DATA 

(blank  line  RETURN) 

~~  SE 

EXEC  CLI 

El  FILE=  El . DATA  ENTITY 

Here,  the  names  used  as  input  are  ENTITY  names  and  the  command 
will  retrieve  all  those  IDENTIFIERS  which  identify  the  ENTITIES. 

The  report  generated  from  this  procedure  is  given  in  Example  7.7a. 

Usage  with  NAME-GEN 

To  retrieve  all  IDENTIFIERS  which  are  also  GROUPS  and  all  IDENTIFIERS 
which  are  also  ELEMENTS  to  be  used  as  input  to  the  command: 

NG  IDG  IDE 
El  I 

The  report  will  be  produced  using  all  the  IDENTIFIER  (which  are  also 
GROU’S  and  ELEMENTS)  in  the  data  base.  Another  common  form  of 
using  NAME-GEN  in  conjunction  with  the  command  is  shown  below. 

NG  ENTITY 
El  E 
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The  report  will  be  produced  using  all  the  IDENTIFIERS  (which 
are  also  GROUPS  and  ELEMENTS)  in  the  data  base.  Another 
common  form  of  using  NAME-GEN  in  conjunction  with  the  command 
Is  shown  below. 

NG  ENTITY 

El  E 

The  report  will  be  generated  using  all  the  ENTITIES  defined 
in  the  URA  data  base.  For.  our. particular  user  requirement  , 
the  output  produced  from  this  sequence  of  commands  is  the  same 
as  shown  In  Example  7.7a. 

Common  Errors 

Since  not  that  many  ENTITIES  or  IDENTITIES  are  defined  in  an 
average  user  requirement  , the  only  thing  to  watch  out  for  is 
that  when  ENTITIES  are  used  as  input  the  ENTITY  parameter  must 
be  given,  etc. 
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8.8  FORMATTED- PROBLEM- STATEMENT  (FPS) 
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Report  Description 

The  FORMATTED  PROBLEM  STATEMENT  1$  generated  when  this  command 
Is  implemented.  Any  type  of  name  in  the  data  base  can  ba  used 
as  input  to  this  command.  For  each  name  used,  the  command 
retrieves  all  information  specified  for  that  name  in  the  data 
base  and  presents  this  in  the  FORMATTED  PROBLEM  STATEMENT. 

The  report  is  generated  in  sections.  The  first  statement  in 
each  section  presents  the  name  and  name  type  being  described 
and  tie  remainder  of  the  section  consists  of  statements  to 
describe  this  name. 

Implementation 

To  generate  an  FPS  report  for  one  name,  the  format  is: 

FPS  N=FI ELD-CHECK-NEW 

All  the  information  known  about  FIELD-CHECK-NEW  in  the  URA 

data  base  will  be  retrieved  and  formatted  as  shown  by  Example  8.8a. 

Options  and  Alternatives 

The  format  of  the  information  presented  by  this  report  can  be 
varied  tremendously  by  using  the  format  parameters: 

SMARG 

NMARG 

AMARG 

BMARG 

RNMARG 

CMARG 

HMARG 

ONE-PER-LINE 

MEW-PAGE 

NEW-LINE 

Figure  8a  illustrates  most  of  the  margin  parameters  by  presenting 
their  default  values.  (HMARG  has  the  value  40  unless  specified 
otherwise.)  A complete  description  for  each  of  these  parameters 
can  be  found  in  Part  II 
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Another  valuable  parameter  for  this  command,  is  PUNCH.  It 
specifies  that  all  the  information  presented  in  the  FORMATTED 
PROBLEM  STATEMENT  should  also  be  written  into  a PUNCH  file,  but 
with  a format  acceptable  by  the  INPUT-PSL  command.  This  would 
be  used  if  a copy  of  the  user  requirement  was  to  be  sent  to 
another  installation.  In  this  case,  the  PUNCH  Information 
might  be  put  on  cards  or  on  tape. 
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Example  8.8b  (cont'd) 


- 


Of  course  the  FILE  parameter  is  allowed  by  this  command,  and  so 
the  FPS  may  be  generated  for  several  names: 

EDIT  FPS. DATA  NONUM  NEW 

PAY-STATEMENT 

ERROR-LIST 

HIRED-TERMINATED-REPORT 
(blank  line  RETURN) 

SE 

EXEC  CLI 

FPS  FI LE=FPS . DATA 


Usage  with  NAME-GEN 

The  FPS  is  often  generated  for  all  names  in  the  data  base  to 
check  the  status  of  the  problem  statement  in  terms  of  size,  con- 
sistency, etc.  To  do  this: 

NG  ALL 

FPS 

Example  8.8b  presents  the  output  generated  by  this  sequence  of 
commands  for  a small  user  requirement  • 

Common  Errors 

It  must  be  kept  in  mind  that  the  volume  of  information  pres^  ted 
by  the  FPS  command  is  several  times  larger  than  the  volume  of 
information  entered  via  INPUT -URL  . For  this  reason,  care  must 
be  taken  when  generating  an  FPS  for  large  user  requirements 
because  it  can  be  very  costly. 
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8.9  FREQUENCY  (FREQ) 

Report  Description 

This  report  presents  information  associated  with  the  HAPPENS 
statement  for  all  INPUT,  OUTPUT,  EVENT  and  PROCESS  names  in 
the  data  base.  The  report  is  broken  into  sections,  with  each 
section  presenting  the  frequency  of  several  objects  for  a 
particular  interval. 

Implementation 

The  only  way  to  generate  the  output  is  to  specify: 

FREQUENCY 

Example  8.9  presents  a simple  form  of  the  report  for  one  interval. 

Options  and  Alternatives 

None 

Usage  with  NAME-GEN 
Not  applicable 
Common  Errors 
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Example  8.9 


8.10  KWIC 


Report  Description 

The  KWIC  INDEX  output  presents  all  names  used  as  input  to  the 
command  and  all  possible  variations  in  this  name  (via  per- 
mutation about  the  dashes  in  each  name)  and  lists  these  in 
alphabetical  order.  Since  most  names  are  selected  for  objects 
according  to  some  criteria  (if  nothing  more  than  all  information 
pertaining  to  employees  is  preceded  by  the  word  "EMPLOYEE") 
this  list  may  be  referenced  when  assigning  names  to  new  objects 
to  be  added  to  the  user  requirement  • 

Implementati on 

One  of  the  most  common  implementations  of  this  conmand  utilizes 
NAME-GEN: 

NG  ALL 

KWIC 

This  will  give  a KWIC  INDEX  of  all  names  in  the  data  base.  From 
this,  naming  conventions  can  be  devised  (or  imposed)  for  the 
user  requirement  . The  results  of  this  implementation  is  shown 
in  Example  8.10a. 

Options  and  Alternatives 

The  DIF  parameter  specifies  the  number  of  columns  a name  should 
be  separated.  It  may  be  changed  for  ease  in  reading. 

The  FILE  parameter  is  available,  but  the  most  effective  way  to 
use  this  command  is  through  NAME-GEN.  . 

Usage  with  NAME-GEN 

Possibly  a more  practical  form  of  this  output  is  to  generate  a 
KWIC  INDEX  for  each  particular  name  type.  Therefore,  all  PROCESSES 
names  could  be  related,  etc. 

NG  PROCESS 

KWIC 

Example  8.10b  presents  this  action. 
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Example  a.lOb(cont'd) 


Report  Description 


The  N\ME  GEN  output  is  a list  of  names  retrieved  from  the 
URA  dita  base  based  on  selection  criteria  specified  by  i ;s 
parameters.  Only  one  type  of  name  may  be  retrieved  for  ;his 
report  or  all  names  in  the  data  base  can  be  presented. 

Implementation 

To  get  a list  of  all  REAL-WORLD-ENTITY  and  PROCESS  names: 

NG  PROCESS  RWE 

A NAME  GEN  output  will  be  generated  as  well  as  a PUNCH  file. 
Both  will  contain  all  the  PROCESS  and  RWE  names  defined  in  the 
data  base.  With  this  list  in  the  PUNCH  file,  it  can  be  used  as 
input  to  other  URA  commands.  See  Example  8.11a  for  the  output 
generated  by  this  command. 

Options  and  Alternatives 

There  are  many  parameters  available  in  specifying  selection 
criteria.  (See  Part  II  , ”URA  COMMAND  descriptions”) 
Parameters  are  available  tor  selecting  particular  name  types 
(PROCESS,  GROUP,  SET,  etc.)  The  ALL  parameter  can  be  used  to 
specify  all  possible  name  types  except  SYNONYMS  and  UNDEFINED 
names: 

NAME-GEN  ALL  (See  Example  8.11b) 

Within  a given  name  type  or  group  of  names  type  you  may  select: 
All  names  with  a given  KEYW0RD=L1 
NG  ALL  KEY=L1 

All  names  (INPUT,  OUTPUT  or  PROCESS)  which  are  SUBPARTS  to  a 
given  name: 

NG  PROC  SO=PAYROLL-PROCESSING 
The  output  for  this  is  presented  by  Example  8.11c 
All  names  with  a given  USER: 

NG  ALL  PD=WALTER-J-RATAJ 

If  two  or  three  of  those  parameters  (KEY,  SO,  PD)  are  used: 

NG  INPUT  SO=TIME-CARD  PD=WALTER-J-RATAJ  KEY=L-1 


the  only  names  that  will  appear  in  the  NAME  GEN  output  are 
those  which  satisfy  all  these  selection  criteria. 

NAME-GEN  utilizes  a PUNCH  file  (defaults  to  URANAMES  if  one 
is  not  specified  ) so  that  the  names  generated  by  this  conmand 
can  be  used  as  input  to  other  report  commands.  For  example, 
when 


NG  ALL 

is  given  the  names  retrieved  by  this  conmand  are  also  put  into 
the  temporary  file,  URANAMES.  You  could  then  issue  an  FPS 
command  for  all  these  names  by  specifying: 

FPS 

This  is  equivalent  to  specifying  the  sequence: 

NG  ALL  PUNCH=  PUNCH 
FPS  F=  PUNCH 

When  the  goal  of  using  the  NAME-GEN  command  is  to  obtain  PUNCH 
output,  the  NAME  GEN  report  output  may  be  omitted  by  giving  the 
NOPRINT  parameter: 

NAME-GEN  ALL  NOPRINT 

Usage  with  NAME -GEN 

Not  Applicable 

Common  Errors 

Care  should  be  taken  that  if  the  names  retrieved  are  to  be  used 
as  input  to  another  command,  that  all  the  names  are  acceptable 
to  the  command.  For  example,  you  would  not  give: 

NG  GROUP  PROCESS 

CONTENTS 

PROCESS  names  are  not  acceptable  to  the  CONTENTS  command  (it 
only  takes  SET,  INPUT.  OUTPUT,  ENTITY  and  GROUP  names)  and  so 
errors  would  be  encountered. 
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8.12  NAME-LIST  (NL) 

Report  Description 

The  NAME  LIST  output  is  produced  by  this  comnand.  This  list 
presents  every  name  defined  in  the  data  base. 

Implementation 

All  that  is  required  to  generate  the  output  is: 

NAME-LIST 

The  output  shown  in  Example  8.12  will  be  produced. 

Options  and  Alternatives 

If  it  is  desired  for  the  names  to  be  grouped  by  type  (e.g., 
all  PROCESSes  together,  all  INPUTS  together),  the  ORDER=BYTYPE 
parameter  should  be  specified: 

NAME-LIST  ORDER=BYTYPE 

Usage  with  NAME-GEN 

Not  applicable 

Comnon  Errors 

None 
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8.13  PICTUIE  (PIC) 


Repor:  Description 

This  output  (also  called  PICTURE)  presents  data  in  the  URA  data 
base  *n  a graphical  format.  This  output  can  be  generatec  for 
apy  o'  the  following  name  types: 

SET 

INPUT 

OUTPUT 

ENTITY 

GROUP 

ELEMENT 

REAL-WORLD-ENTITY 

PROCESS 

The  information  retrieved  is  dependent  on  the  type  of  name  the 
report  is  being  generated  for.  A separate  PICTURE  is  given  for 
each  name  used  as  input. 

Implementation 

To  get  a PICTURE  for  one  name  In  the  data  base: 

PICTURE  N=PAYCALC-UP DATING 

The  output  generated  for  this  is  shown  by  Example  8.13a.  All 
Information  relating  this  PROCESS  to  data  (SETS,  GROUPS,  etc.), 
INPUTS,  OUTPUTS  and  other  PROCESSES  will  be  presented  by  this 
report. 

Options  and  Alternatives 

To  omit  FLOW  information  from  the  PICTURE  (information  relating 
PROCESSES  with  INPUTS  and  OUTPUTS)  specify  "NOFLOW"  as  a parameter. 

To  omit  DATA  information  from  the  PICTURE  (information  relating 
PROCESSES  with  SETS,  ENTITIES,  GROUPS,  and  ELEMENTS)  specify 
"NOQATA"  as  a parameter. 

For  example, 

PICTURE  N=PAY ROLL-PROCESSING  NODATA  NOFLOW 

produces  the  output  shown  by  Example  8.13b. 

To  omit  STRUCTURE  information  from  the  PICTURF  (information  re- 
trieval from  the  SUBPARTS  or  CONSISTS  pr  SUBSETS  statements  for 
that  name)  specify  "NOSTRUCTURE."  Example  8.13c  presents  the 
output  generated  when  given: 


PICTURE  N=PAYROLL-PROCESSING  NOSTRUCTURE 


The  PICTURE  output  may  be  obtained  for  several  names  via  the 
FILE  parameter: 


EDIT  PIC. DATA  NONUM  NEW 
PAY-STATEMENT 
ERROR-LISTING 
PAYSYSTEM-OUTPUTS 
(blank  line  RETURN) 

SE 

EXEC  CLI 

PIC  FILE=PIC. DATA 

An  index  to  the  output  may  be  obtained  by  giving  INDEX  as  a 
parameter. 

Usage  with  NAME-GEN 

NAME-GEN  can  be  used  to  retrieve  names  for  use  by  this  command 
in  the  following  manner: 

NG  INPUT  OUTPUT 
PIC 

A PICTURE  will  be  generated  for  each  INPUT  and  OUTPUT  name  in  the 
PSA  data  base.  The  most  common  use  of  this  combination  of  commands 
Is: 

NG  PROCESS 
PIC 

Common  Errors 

For  each  name  used  as  input  to  the  command  at  least  one  page  of 
output  is  generated.  This  can  result  in  quite  a lot  to  handle. 

It  is  best  to  send  this  output  to  *PRINT*  via  the  SET  command. 
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Example  8. 13c 
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8.14  PRINT  ATTRIBUTE-VALUES 


Repor:  Description 

The  report  generated  by  this  command  is  called  the  ATTRIBUTE 
REPOR"  and  presents,  for  each  ATTRIBUTE  name  used  as  input  to  the 
coninai  d,  all  those  names  in  the  data  base  it  is  an  ATTRILlfTE  for 
and  tie  value  it  takes  on  for  that  name. 

Implementati  on 

To  get  the  basic  report: 

PAV  N*TYPE 

The  output  generated  is  shown  in  Example  8.14. 

Options  and  Alternatives 

You  may  also  enter  ATTRIBUTE  names  into  a file  to  be  used  as 
Input  to  the  command: 

EDIT  PAV. DATA  NONUM  NEW 

TYPE 

MODE 

(blank  line  RETURN) 

SE 

EXEC  CLI 

PAV  FILE= PAW. DATA 
Usage  with  NAME-GEN 

This  command  can  effectively  be  used  in  conjunction  with  NAME- 
GEN  in  the  following  manner: 

NG  ATTRIBUTE 
PAV 

Information  will  be  presented  for  all  ATTRIBUTES  defined  in  the 
data  base. 

Common  Errors 


It  Is  necessary  that  only  ATTRIBUTE  names  be  used  as  input  to 
the  command.  Any  other  name  types  will  generate  error  diagnostics. 
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8.15  PROCE  .S-INPUT-OUTPUT  (PRIO) 


Repor:  Description 

This  -:onmand  produces  the  PROCESS  INPUT/OUTPUT  report.  cor 
those  PROCESS  names  used  as  input  to  the  command  It  retrieves 
data  ?low  information  (via  the  USES,  RECEIVES,  GENERATES, 

DERIVES  and  UPDATES  relationships  specified  in  the  data  base) 
and  presents  it  in  a narrative,  outline  format. 

Implenentati on 

To  generate  the  basic  form  of  the  report  for  one  name: 

PRIO  N-PAYROLL-PROCESSING 

This  generates  the  information  in  the  format  shown  by  Example  8.15a. 
Options  and  Alternatives 

Any  of  the  Information  in  the  report  can  be  omitted  by  specifying 
various  parameters.  For  example,  NDESC  can  be  given  and  the 
DESCRIPTION  comment  entry  associated  with  the  PROCESS  names  will 
not  be  printed. 

The  PROCEDURE  comment  entry  associated  with  PROCESS  names  can  be 
Included  in  the  report  when  the  "PRCD"  parameter  Is  also  given. 

The  format  of  the  report  can  be  altered  somewhat;  each  PROCESS 
can  have  the  information  about  it  printed  on  a separate  page  when 
the  "NEW-PAGE"  parameter  Is  given. 

Of  course  this  report  can  be  generated  for  several  names  when  the 
"FILE”  parameter  Is  specified. 

Below  Is  an  example  Illustrating  some  of  the  options  described 
above: 

EDIT  PRIO. DATA  NONUM  NEW  BLOCK (800) 

NEW-EMPLOYEE- PRINTING 
NEW- EMPLOYEE- UPD  ATI NG 
(blank  line  RETURN) 

SE 

EXEC  CLI 

PRIO  F=PRIO. DATA  NDESC  NPG  PRCD 

This  procedure  produces  the  report  for  the  two  names  in  the  file 
'T.DATA' , the  PROCEDURE  comment  entry  is  printed  instead  of  tne 
DESCRIPTION  comment  entry,  and  each  PROCESS  is  described  on  a new 
page.  Example  8.15b  presents  the  outcome  of  this  procedure. 


J 
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Another  option  available  is  to  utilize  the  PUNCH  facility 
to  obtain  a list  of  data  names  (SETS,  INPUTS,  OUTPUTS,  ENTITIES, 
GROUP  and  ELEMENTS)  related  to  the  PROCESSES  in  the  report. 

This  may  be  desirable  to  be  used  as  input  to  another  report 
command: 

PRIO  N-PAYROLL-PROCESSING  NP  PUNCH-  PUNCH 
DATA  PROCESS  F-  PUNCH,  DATA 

In  this  implementation,  the  data  associated  with  PAYROLL- 
PROCESSING is  being  used  as  Input  to  the  OATA-PROCESS  command  to 
see  how  it  realtes  to  other  PROCESSES. 

Usage  with  NAME-GEN 

It  Is  quite  easy  to  use  NAME-GEN  to  retrieve  PROCESS  names  to 
be  used  as  input  to  the  command: 

NG  PROCESS 
PRIO 

The  report  will  be  generated  for  all  PROCESS  names  In  the  data 
base. 

Common  Errors 


The  main  thing  to  watch  out  for  is  that  all  names  used  as  input 
are  PROCESS  names. 
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fxample  8.15a 


PROCESS  INPUT/OUTPUT 


Example  8.15b  (cont'd) 
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8.16  PUNCH  COMMENT-ENTRY  (PCOM) 


Report:  Description 

The  PUNCHED  COMMENT  ENTRIES  output  is  generated  by  this  command. 
It  p ■esents  selected  comment  entries  for  each  name  used  as 
input  to  the  command.  Any  type  of  name  may  be  used  as  i;iput  to 
the  cxnmand.  Depending  on  the  type  of  name  the  following  comment 
entries  may  be  retrieved: 


DERIVATION 

(DER) 

DESCRIPTION 

(DESC) 

FALSE-WHILE 

(FW) 

PROCEDURE 

(PRCD) 

TRUE -WHILE 

(TW) 

VOLATILITY 

(VOL) 

VOLATILITY-MEMBER 

(VOLM) 

VOLATILITY-SET 

(VOLS) 

Implementation 

To  obtain  the  DESCRIPTION  comment  entry  for  one  name: 

PCOM  N=PAYROll-PROCESSING  DESC 

This  will  generate  the  report  shown  in  Example  8.16a.  A PUNCH 
file  will  also  be  generated  with  the  same  information  as  the 
report.  This  file  can  then  be  editted  and  used  as  input  to  the 
RCOM  command: 

EDIT  URAPCOM 
(edit  commands) 

SE 

EXEC  CLI 
RCOM  I = URAPCOM 

Options  and  Alternatives 

The  FILE  parameter  allows  comment  entries  generated  for  several 
names: 

EDIT  PCOM. DATA  NONUM  NEW 

EMPLOYEE 

TIME-CARD 

PAY-STATEMENT 

(blank  line  RETURN) 

SE 

EXEC  CLI 

PCOM  F=PCOM. DATA  DESC 
The  output  for  this  is  given  in  Example  8.16b. 
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Multiple  conment  entries  can  also  be  generated  for  several 
names: 

EDIT  PCM. DATA  NONUM  NEW 
NEW-EMPLOYEE- PRINTING 
NEW- INFO- VALIDATION 

(blank  line  RETURN)  * 

SE 

EXEC  CLI 

PCOM  F= PCM. DATA  DESC  PRCD 
The  resulting  output  is  shown  in  Example  8.16c. 

When  the  objective  of  implementing  this  command  is  to  generate 
a PUNCH  file,  printing  of  the  report  may  be  surpressed  by  issu- 
ing NOPRINT  so  the  command  may  appear  as: 

PCOM  F=T.DATA  PUNCH*  PUNCH  NOPRINT 

Usage  with  NAME -GEN 

One  or  more  comment  entries  may  be  retrieved  for  a given  name 
type: 

NG  RUE 
PCOM  DESC 

or  for  several  name  types: 

NG  SET  PROCESS 
PCOM  DESC  PRCD 

Notice  that  the  PRCD  parameter  is  given,  but  SETS  cannot  have 
PROCEDURE  statements  associated  with  them.  Only  the  DESCRIPTION 
statements  will  be  retrieved  for  SET  names  while  both  DESCRIPTION 
and  PROCEDURE  statements  will  be  retrieved  for  PROCESS  names. 

Common  Errors 


The  user  should  note  that  most  of  the  parameters 

(FALSE-WHILE,  VOLATILITY,  etc.)  can  only  apply  to  one  type  of 
name  (CONDITION,  ENTITY,  respectively).  : 
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Example  - 8. 16c 


3 


8.17  STRUCTURE  (STR) 

Report  Description 

The  STRUCTURE  output  is  generated  by  this  comnand.  It  presents 
structures  in  the  user  requirement  specified  through  usage  of 
the  SUBPARTS  statement.  For  this  reason,  the  STRUCTURE  output 
is  only  available  for  REAL-WORLD-ENTITIES,  INPUTS,  OUTPUTS  and 
PROCESSES  defined  in  the  user  requirement. 

Implementation 

To  get  the  STRUCTURE  report  for  all  PROCESSES  defined  in  the 
data  base  specify: 

STRUCTURE 

The  resulting  output  is  shown  by  Example  8.17a. 

Options  and  Alternatives 

The  STRUCTURE  report  may  be  obtained  for  either  INPUTS  or  OUTPUTS 
or  REAL-WORLD-ENTITIES  or  PROCESSES.  To  generate  a report  for 
INPUTS: 

STR  INPUT 

This  output  is  shown  by  Example  8.17b. 

The  format  of  the  output  can  be  altered  somewhat  by  reassigning 
a value  for  INDENT.  It  specifies  the  number  of  spaces  to  indent 
each  succeeding  level  of  the  structure.  We  could  do  this  by: 

STR  INDENT=10  ' 

INDENT  can  take  on  any  integer  value,  1 through  10. 

Us age- with  NAME-GEN 

Not  applicable. 

Common  Errors 

None. 
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Example  8.17b 


8.18  SUMMAF 1 (SUM) 

Report  Description 

The  DATA  BASE  SUMMARY  is  produced  by  this  command.  This  report 
presents  statistical  information  concerning  the  use  of  each 
name  type  possible  in  the  URA  data  base.  For  example,  this 
report  presents  the  number  of  PROCESSES,  SETS,  etc.  that  nave 
been  defined  in  the  data  base  as  well  as  the  number  of  these 
which  have  DESCRIPTION  and  SYNONYM  relationships  assigned  to 
them. 

Implemantati  on 

There  is  only  one  w*y  to  implement  this  report: 


The  DATA  BASE  SUMMARY  for  a small  data  base  was  produced  as  shown 
in  Example  8.18a. 

Options  and  Alternatives 


None. 


Usage  with  NAME-GEN 
Not  applicable. 
Coninon  Errors 


None. 


Example  8.18a 


9.  Erro'  Diagnostics 

URA  | as  extensive  error  checking  facilities  to  a|d  the  users 
In  preventing  errors  In  their  problem  statement.  At  the  URA 
comm  nd  mode  level,  checks  are  made  that  all  commands  g ven 
are  egal  URA  commands  and  all  parameters  given  are  legd 
parameters  for  that  command.  If  an  Illegal  command  Is  tjlven, 
an  Illegal  parameter,  or  Illegal  parameter  for  that  conriand, 
the  following  message  will  be  generated: 

INVALID  PARAMETER  - 
ENTER  REPLACEMENT  OR  BLANK  LINE 
? 

The  user  must  enter  the  replacement  following  the  question  mark 
and  then  hit  the  carriage  return  key.  Tf  the  command  is  accepted, 
processing  of  that  command  commences.  Should  an  error  be  en- 
countered while  processing  the  command,  one  of  the  following 
three  types  of  error  diagnostics  will  be  given: 

i)  Data  Base  Management  System  Errors 

These  errors  are  encountered  when  there  may  be 
some  danger  of  destroying  the  contents  of  the 
URA  data  base  or  there  Is  a bug  in  the  URA  soft- 
ware. Even  though  the  URA  software  might  be  the 
cause  of  the  error,  it  is  doubtful  if  tt  will 
do  anything  to  harm  the  contents  of  the  users 
data  base. 

***  ERROR  16  - DATA  BASE  FILE  INCONSISTENT 

This  error  message  is  given  if  the  user  attempts 
to  modify  or  retrieve  information  from  a URA 
data  base  which  has  had  its  contents  altered 
so  that  It  is  unusable  by  the  URA  software. 

There  is  no  way  to  recover  from  this  type  of 
error  unless  a save  file  is  kept  (See  the  SAVE 
command  In  Section  8.2). 

***  ATTENTION  TRAPPED  BY  D.B.  HANDLER 

This  message  is  given  whenever  the  user  uses  the 
Break  button  (control-E)  to  get  out  of  URA  mode. 

To  return  to  URA  the  user  must  issue  the  EXEC  cli 
command.  If  an  ATTENTION  is  given  by  the  user 
while  URA  is  processing  a modifier  command  (like 
INPUT4JRL),  It  is  necessary  that  the  user  issue 
EXEC  CLI  or  the  contents  of  the  URA  data  may 
become  unusable.  There  is  no  such  danger  If 
URA.  is  processing  a report  command. 
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****  ERROR  # n FOUND  IN  ROUTINE  # m 

An  error  message  of  this  format  usually  designates 
a bug  in  the  URA  software,  where  n is  the  error  number. 
If  the  values  of  the  variables  n and  m are  16  and 
3Q  respectively,  the  error  designates  a data  base 
tnconsHtency  which  is  usually  a user  error.  Any 
other  errors  of  this  form  with  different  values 
should  be  brought  to  the  attention  of  those  persons 
maintaining  the  URA  software. 

it)  URA  Command  Errors 

These  errors  are  encountered  in  the  processing  of 
URA  commands  and  are  user  errors.  These  diagnostics 
are  generated  when  the  user  presents  ambiguous  or 
incorrect  information  to  the  commands.  In  most 
cases,  URA  will  take  no  action  to  fulfill  the  users 
request  if  an  error  is  encountered.  The  command  must 
be  restated  corrected  form,  before  action  is  taken. 

All  these  commands  are  presented  In  the  following 
format: 

URAnnn: subroutine:  error-message 

where  "nnn"  designates  the  URA  error  number,  "sub- 
routine", the  subroutine  in  the  URA  software  where 
the  error  occurred,  and  "error-message"  some  diag- 
nostics to  why  an  error  was  encountered. 

Ill)  URA  Input  Errors 

These  errors  are  a specific  type  of  URA  command  error 
which  are  encountered  when  using  the  INPUT4JRL  or 
DELETE -URL  commands  incorrectly.  URA  always  attempts 
to  recover  from  these  errors  unless  an  excess  number 
have  been  encountered.  Each  of  these  errors  are 
assigned  a level  number,  1 through  4.  The  user  is 
allowed  to  make  up  to  24  level  1 and  24  level  2 errors, 
but  a single  level  3 or  level  4 error  will  terminate 
processing  of  the  command.  The  levels  are  described 
below. 

Level 
1 
2 

3 

4 


These  types  of  errors  are  presented  In  the  following 
format: 

****  LEVEL  j,  URAnnn: subroutine: error-message 

where  "j"  designates  the  level  number  and  "nnn", 
the  URA  error  number.  The  last  part  of  the  format 
ts  the  same  as  the  standard  URA  command  errors. 

After  processing  any  URA  commano,  a STOP  statu.,  message  Is  given. 
This  message  designates  that  processing  of  the  command  was  success- 
ful (STOP  0,  t.e.,  errors  were  handled  effectively  etc.),  or  that 
processing  was  not  totally  successful  (STOP  4).  STOP  4 is  given 
when  a level  limit  is  exceeded  for  INPUT -URL  errors,  for  example. 
The  following  is  a list  of  all  possible  errors  that  can  be  en- 
countered while  using  URA.  a short  description  of  each  command 
accompanies  it  as  well  as  suggested  action  to  take  should  the 
error  occur. 
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nm  TOO  LONG 

A user  defied  name  lias  exceeded  the  3a  character 
limit  allowed  by  URL/URA.  The  name  is  truncated 
to  3Q,  but  ts  still  put  tn  data  base.  See  Sectton 
1Q.1  of  thts  paper. 

'EOF'  NOT  FOUND  BEFORE  END-OF-FILE 
The  user  has  terminated  the  input  by  a $ENDFILE 
(or  CONTROL-C)  rather  than  the  URL  'EOF'.  Process- 
ing of  the  Input  ts  terminated. 

ILLEGAL  CHARACTER  - TREATED  AS  BLANK 
An  illegal  character  encountered  in  an  Input  line 
or  legal  URL  character  is  used  in  the  wrong  context. 
See  ESD  TR  # 7 5-88,  vol  ii  for  list  of  legal 
characters.  Statement  with  this  error  may  not  be 
deleted. 

END-OF-FILE  IN  MIDDLE  OF  COMMENT 
A $ENDFILE  (or  CONTROL-C)  has  been  encountered 
following  the  '/*'  comnent  characters.  Processing 
of  the  input  is  terminated. 

INVALID  LEXICAL  TYPE  RETURNED  FROM  NLEX 
URA  software  error.  Please  notify  persons  maintain- 
ing URA  should  this  error  occur. 

ILLEGAL  CHARACTER  - IGNORED 

An  illegal  character  encountered  when  scanning  an 
Input  line.  See  ESD  TR#  75-88.  vol  tt  for 
complete  list  of  legal  characters.  Statement  with 
this  error  may  not  be  deleted. 


8  COMLOP:  PARSE  STACK  OVERFLOW 

URA  software  error.  Please  notify  persons  maintain 
Ing  URA  should  this  error  occur. 


9  PROK:  BAD  CASE 

URA  software  error.  Please  notify  persons  maintaining 
URA  should  this  error  occur. 


10  REDUCE:  NO  APPLICABLE  PRODUCTION  - SYNTAX  ERROR  - START  SKIPPING 

Illegal  URL  statement  syntax  is  encountered.  If  this 
is  a header  statement,  following  statements  will  be 
assigned  to  the  previous  header  statement.  Error  may 
be  result  of  incorrect  usage  of  a URL  reserved  word, 
see  Section  10.1. 


11  STACK:  ILLEGAL  SYMBOL  PAIR  - SYNTAX  ERROR  - START  SKIPPING 

Illegal  URL  statement  syntax  is  encountered.  If  this  is 
a header  statement,  following  statements  will  be  assigned 
to  the  previous  neader  statement.  This  statement  is 
not  entered  into  the  URA  data  base.  (See  Section  10.1). 
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Number  Subrout  ^ne  Error  Message 


12  SYMBOL: 


13  SYMBOL: 


14  SETYPE: 


15  STACK: 


16  COMENT: 


17  SKIP: 


18  IDENT: 


19  RECOV: 


20  RECOV: 


21  SETINF: 


22  OTHERS: 


23  SUBPRT : 


SYMBOL  TABLE  OVERFLOW 

Exceeded  lfrotts  of  URA.  Reissue  INPUT-URL  ccnmand  at 
pdtnt  th  the  tnput  ffle  where  th.t$  error  occurred, 

TOO  MANY  SYMBOLS 

Exceeded  limits  of  URA.  Reissue  INPUTWJRL  ccunand  at 
potnt  in  the  tnput  file  where  this  error  occurred. 

INVALID  SYMBOL  TABLE  POINTER 

URA  software  error.  Please  notify  persons  maintain- 
ing URA  should  this  error  occur. 

INVALID  CASE 

URA  software  error.  Please  notify  persons  maintaining 
URA  should  this  error  occur. 

END-OF-PILE  IN  COMMENT  ENTRY 

A $ENDFILE  (or  CONTROL-C)  encountered  in  URL  conuient 
entry.  Processing  of  the  input  is  terminated. 

END  OF  FILE  WHILE  SKIPPING 

Serious  error.  In  attempt  to  recover  from  previous 
errors  the  end  of  input  has  been  encountered.  Process- 
ing of  input  is  terminated. 

NO  NAMES  IN  DATA  BASE 

Attempt  to  retrieve  names  from  an  empty  data  base. 

UNABLE  TO  RECOVER  AT  THIS  TIME 

Processing  of  Input  is  terminated  due  to  serious  errors 
which  make  it  unable  to  continue. 

LAST  STATEMENT  SKIPPED 

Statement  where  error  occurred  is  skipped  so  that  process- 
ing of  Input  may  continue. 

INVALID  SYMBOL  TABLE  POINTER 

URA  software  error.  Please  notify  persons  maintaining 
URA  should  this  error  occur. 

SAME  ATTRIBUTE  ALREADY  GIVEN  WITH  DIFFERENT  ATTRIBUTE  VALUE 
An  attempt  was  made  to  assign  a second  value  to  the  same 
ATTRIBUTE  for  a given  name.  The  new  value  is  ignored. 

TOO  MANY  LEVELS  - STACK  OVERFLOW 

The  limit  allowed  for  retrieving  names  via  the  SUBPARTS- 
OF  parameter  has  been  exceeded.  Reissue  the  NAME-GEN 
command  with  the  last  name  retrieved  as  the  value  for 
the  SUBPARTS-OF  parameter. 
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Error  Message 


Number  Subroutine 


24  MAINRCOM: 

25  HEAD: 

26  IGINFO: 

27  PTABIN: 

29  CHKREL : 

30  CHKREL : 

31  MAINCT: 

32  MAINCT: 

33  MAINCT: 

34  MAINCT: 

35  MAINCT: 

36  MAINCT: 


MISSING  SEMICOLON  ON  LINE  AFTER  NAME 

Serotcolon  \s  needed  to  terminate  comnjent  entry  statement. 

INVALID  HEADER  STATEMENT  - STATEMENTS  WILL  BE  IGNORED 
Illegal  syntax  of  Header  statement.  All  URL  statements 
up  to  the  next  header  statement  will  be  Ignored. 

INVALID  SYMBOL  TABLE  POINTER 

URA  software  error.  Please  notify  persons  maintaining 
URA  should  this  error  occur. 

INVALID  LEXICAL  TYPE  OR  END-OF-FILE 

URA  software  error.  Please  nottfy  persons  maintaining 

URA  should  this  error  occur. 

CONFLICT  WITH  EXISTING  CONNECTIONS  (RELB)  RELTYP  # 

Attempt  made  to  change  name  type  to  one  which  conflicts 
with  the  context  In  which  the  name  Is  used.  No  change 
ts  made. 

CONFLICT  WITH  EXISTING  CONNECTIONS  (RELB)  RELTYP  # 

Attempt  made  to  change  name  type  to  one  which  conflicts 
with  the  context  In  which  the  name  Is  used.  No  change 
Is  made. 

BAD  INPUT  FORMAT 

The  format  of  the  file  used  as  in  put  to  the  command  is 
Incorrect.  See  the  command  description  for  correct 
format.  No  change  Is  made. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  change  name  tupe  of  name  not  defined  in  the 
URA  data  base. 

INVALID  NAME  TYPE 

Attempt  to  assign  an  Illegal  name  type  to  a name. 

Probably  a spelling  error. 

NAME  TYPE  TOO  LONG 

Attempt  to  assign  an  illegal  name  type  to  a name. 

Probably  a spelling  error. 

WARNING  - STUFF  AFTER  NAME  TYPE 

The  Input  file  contains  more  than  just  name  and  new 

name  type.  The  extra  data  will  be  Ignored  by  the  conmand. 

INVALID  NAME  - TOO  LONG 

The  name  for  which  the  change  ts  to  be  made  ts  over  30 
characters.  Check  spelling. 
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Number  Subrout-  ne  Error  Message 


37  FNDPD: 

38  MAINREN 

39  MAINREN : 

40  CLREN : 

41  MAINDEL: 

42  MAINDEL: 

43  OTHERS: 

44  OTHERS : 

45  CLCT: 

46  CT: 

47  MAINN6: 

48  MAINNG: 

49  MAINNG: 


THIS  IS  NOT  A PD  FOR  ANY  NAMES  - 

This  problem  deftner  ts  not  associated  to  any  names 

defined  in  the  data  base. 

OLD  NAME  NOT  IN  D.B, 

Attempt  to  change  name  of  some  object  which  Is  not 
defined  tn  the  data  base.  Probably  a spelling  error. 

NEW  NAME  ALREADY  IN  D.B. 

Attempt  to  change  old  name  to  a name  already  defined 
tn  the  data  base.  User  must  choose  another  name. 

MUST  GIVE  OLD  AND  NEW,  OR  INPUT 
Parameters  given  for  the  conmand  do  not  supply  suf- 
ficient information  for  processing.  Reissue  command. 

NAME  TO  BE  DELETED  NOT  IN  D.B. 

Attempt  to  delete  a name  which  is  not  defined  in  the 
URA  data  base. 

INVALID  MEMBER  TYPE 

URA  software  error.  Please  notify  persons  maintain- 
ing URA  should  this  error  occur. 

CARDINALITY  ALREADY  GIVEN  AS  SYSPAR 
Attempt  to  assign  a numerical  value  to  a CARDINALITY 
statement  when  previously  assigned  a SYSTEM-PARAMETER 
name.  The  value  is  Ignored. 

CARDINALLY  ALREADY  GIVEN  AS  DIFFERENT  VALUE 
Attempt  to  assign  a second  value  to  a CARDINALITY 
statement.  The  new  value  is  Ignored. 

NO  TYPE  GIVEN  WITH  "NAME="  OR  "FILE”  PARAMETER 
No  new  name  type  has  been  specified.  The  command 
must  be  reissued. 

NO  NAME  GIVEN 

No  name  has  been  specified  to  have  its  name  type  changed. 
The  NAME  or  FILE  parameter  must  be  given. 

PD  NOT  FOUND  IN  DATA  BASE 

The  user  specified  by  the  PD  parameter  is 

not  defined  tn  the  data  base.  No  names  will  be  generated. 

KEYWORD  NOT  FOUND  IN  DATA  BASE  - 

The  keyword  specified  by  the  KEYWORD  parameter  is  not 
defined  in  the  data  base.  No  names  will  be  denerated. 

NO  NAMES  IN  DATA  BASE 
No  names  have  been  defined. 
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Number  Subroutine 
50  PLIST : 


51  RWLIST: 

I 52  IDENTC: 

53  OPTRW : 

54  OPTRW: 

55  OPTRW: 

56  USEDTO: 

57  USEDTO: 

58  OPTRW: 

59  MAINNG: 

60  APPLES: 

61  RWLIST : 

62  RWLIST: 


Error  Message 

TOO  MANY  NAMES  - REST  IGNORED 

Exceeded  50  name  Itmtt.  Remaining  names  should  be 

given  tn  another  statement, 

MUST  BE  SUBSETTING  CRITERION  NAME 

Attempt  to  define  a name  which  Is  not  a GROUP  or 

ELEMENT  to  be  SUBSETTING  CRITERION. 

NAME  NOT  IN  D.B.  - 

Attempt  to  retrieve  information  about  a name  which  is 
not  defined  tn  the  data  base. 

NAME  LIST  TOO  LONG  - REST  IGNORED 

Exceeded  50  name  limit.  Remaining  names  should  be 

given  in  another  statement. 

NAME  LIST  TOO  LONG  - REST  IGNORED 

Exceeded  50  name  limit.  Remaining  names  should  be 

given  in  another  statement. 

NAME  LIST  TOO  LONG  - REST  IGNORED 

Exceeded  50  name  limit.  Remaining  names  should  be 

given  in  another  statement. 

TOO  MANY  NAMES  - REST  IGNORED 

Exceeded  50  name  limit.  Remaining  names  should  be  given 
in  another  statement. 

TOO  MANY  NAMES  - REST  IGNORED 

Exceeded  50  name  limit.  Remaining  names  should  be 

given  tn  another  statement. 

NAME  LIST  TOO  LONG  - REST  IGNORED 

Exceeded  50  name  limit.  Remaining  names  should  be 

given  in  another  statement. 

SUBPARTS-OF  NAME  NOT  IN  DATA  BASE  - 

Attempt  to  retrieve  names  that  are  a part  of  a name 

not  defined  in  the  data  base. 

SECOND  MAILBOX  FOR  PD  ILLEGAL 

Attempt  to  associate  a second  MAILBOX  to  a particular 
USER. 

ALREADY  PART  OF  SOMETHING  ELSE 

Attempt  to  define  a structure  where  an  object  is  PART 
OF  more  than  one  other  object.  This  is  contrary  to 
the  rules  specified  in  esd  tr  # 75-88,  vol  n . 

SECOND  PD  FOR  THIS  ITEM  ILLEGAL 

Attempt  to  assign  a second  RESPONSIBLE- USER 

to  an  object.  This  statement  is  ignored. 
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Number  Subroutine 

63  RWUST: 

64  MAINDICT: 

65  MAINC0N1 : 

66  MAINPIC: 

67  MAINPrC: 

68  REPSET: 

69  REPSET: 

70  CLDCOM: 

76  MAINPRIO: 

87  CLDEL: 

88  MAINPRIO: 

89  MAINNG: 


Error  Message 

ALREADY  PART  OF  SOMETHING  ELSE 
Attempt  to  define  a structure  where  an  object  Is 
PART  OF  more  than  one  other  object.  This  ts  contrary 
to  rules  specified  iti  esd  tr  # 75-88,  .voi  n . 

NAME  NOT  FOUND  TN  D.B. 

Attempt  to  retrteye  Information  about  name  that  Is  not 
defined  In  the  data  base. 

NAME  NOT  FOUND  IN  D.B.  - 

Attempt  to  retrieve  Information  about  name  that  Is  not 
deftned  In  the  data  base. 

NAME  NOT  TN  D.B.  - 

Attempt  to  retrieve  Information  about  name  that  Is  not 
deftned  In  the  data  base. 

PICTURE  NOT  AVAILABLE  FOR  - 

Attempt  to  generate  a report  for  a name  which  Is  not 
a SET,  INPUT,  OUTPUT,  ENTITY,  GROUP,  ELEMENT,  PROCESS 
or  REAL-WORLD-ENTITY. 

WARNING  - MISSING  SEMICOLON.  NEW  COMMENT  ENTRY  ADDED 
Semicolon  not  given  to  terminate  comment  entry.  One 
Is  assumed  and  processing  continues. 

NO  NEW  COMMENT  ENTRY  - OLD  ENTRY  HAS  BEEN  DELETED 
Since  no  new- comment  entry  has  been  given  to  replace 
the  old,  the  old  comment  entry  statement  Is  deleted. 

NO  NAME  OR  FILE  SPECIFIED 

Either  the  NAME  or  FILE  parameter  must  be  given  for 
this  command  to  be  Implemented. 

NAME  NOT  IN  DATA  BASE  - 

Attempt  to  retrieve  Information  about  a name  that  is 
not  defined  in  the  data  base. 

NO  NAME  OR  FILE  WAS  SPECIFIED. 

Either  the  NAME  or  FILE  parameter  must  be  given  for 
this  command  to  be  implemented. 

NAME  NOT  A PROCESS  NAME  - 

Attempt  to  retrieve  information  from  a name  that  is  not 
a PROCESS  name. 

NAME  MUST  BE  INPUT,  OUTPUT,  PROCESS,  OR  RWE  FOR  "SO" 
PARAMETER 

Attempt  to  retrieve  SUBPARTS  Information  for  a name  whlc 
Is  not  an  OUTPUT,  INPUT,  PROCESS  or  REAL -WORLD-ENTITY. 
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Number  Subroutine 


90  RWUST: 

91  ADDUSE; 

92  MAINPAV: 

93  MAINPAV: 

94  INSYNU: 

95  CLEI ; 

98  CONCOL: 

98  IDENTR: 

100  ATLIST: 

101  ATLIST: 

102  ATLIST: 


SSCN  rs  ONLY  LEGAL  TYPE  IN  DEFINE  SECTION  WHICH  CAN 
BE  MAINTAINED 

Attempt  to  use  MAINTAINED  statement  for  some  object 
whteb  Is  not  SOB5E.niNQ-CRITEAI0N, 

TOO  MANY  USAGES 

URA  software  error.  Please  notify  persons  maintain- 
ing URA  should  this  error  occur. 


NAME  NOT  IN  D.B.  - 

Attempt  to  retrieve  Information  about  name  which  ts 
not  defined  In  the  data  base. 

NAME  HAS  NO  USAGES  AS  ATTRIBUTE  FOR  ANYTHING  - 
Attempt  to  retrieve  ATTRIBUTE  Information  for  a name 
which  Is  not  an  ATTRIBUTE. 

ERROR  OPENING  DATA  BASE 

Attempt  to  access  a data  base  file  which  Is  incon- 
sistent. If  a newly  created  file  be  sure  to  $C0PY 
SEDJ: URAINITDB  TO  data-base-file.  (See  Section  10.1 
of  this  paper). 

MUST  GIVE  EITHER  ENTITY  OR  IDENTIFIER  PARAMETER 
Either  the  ENTITY  or  IDENTIFIER  parameter  must  be 
used  In  conjunction  with  this  command  for  successful 
Implementation. 

NAME  NOT  IN  D.B.  - 

Attempt  to  retrieve  information  about  a name  not 
defined  in  the  data  base. 

NAME  NOT  IN  D.B.  - 

Attempt  to  retrieve  information  about  a name  not  defined 
in  the  data  base. 

TOO  MANY  ATTRIBUTE  VALUE  PAIRS  IN  SINGLE  STATEMENT 
Limit  exceeded.  Remaining  pairs  should  be  given  in 
another  statement. 

NAME  MUST  BE  ATTRIBUTE  NAME 

Attempt  to  use  a name  defined  as  something  else  as  an 
ATTRIBUTE  name. 

NAME  MUST  BE  ATTRIBUTE  VALUE  NAME 

Attempt  to  use  a name  defined  as  something  else  as  an 

ATTRIBUTE-VALUE  name. 
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Number 

Subrout  ne 

Error  Message 

103 

DELSET: 

DESCRIPTION  COMMENT  ENTRY  NOT  FOUND  FOR  ; 

Attempt  to  delete  a nonexistent  DESCRIPTION  s -.atement. 

104 

DELSET: 

PROCEDURE  COMMENT  ENTRY  NOT  FOUND  FOR  : 

Attempt  to  delete  a nonexistent  PROCEDURE  sta:ement. 

105 

DELSET: 

VOLATILITY  COMMENT  NOT  FOUND  FOR  : 

Attempt  to  delete  a nonexistent  VOLATILITY  statement. 

106 

DELSET: 

VOLATILITY-MEMBER  COMMENT  ENTRY  NOT  FOUND  FOR  : 
Attempt  to  delete  a nonexistent  VOLATILITY-MEMBER 
statement. 

107 

DELSET: 

VOLATILITY-SET  COMMENT  ENTRY  NOT  FOUND  FOR  : 

Attempt  to  delete  a nonexistent  VOLATILITY-SET  statement. 

108 

DELSET: 

DERIVATION  COMMENT  ENTRY  NOT  FOUND  FOR  : 

Attempt  to  delete  a nonexistent  DERIVATION  statement. 

109 

DELSET: 

TRUE  WHILE  COMMENT  ENTRY  NOT  FOUND  FOR  : 

Attempt  to  delete  a nonexistent  TRUE  WHILE  statement. 

110 

DELSET: 

FALSE  WHILE  COMMENT  NOT  FOUND  FOR  : 

Attempt  to  delete  a nonexistent  FALSE  WHILE  statement. 

111 

MAINDCOM: 

NAME  NOT  FOUND  IN  D.B.  : 

Attempt  to  delete  Information  for  a name  not  defined 
in  the  data  base. 

113 

CL  CM: 

MUST  GIVE  EITHER  CONSISTS  OR  CONTAINED  PARAMETER 

Either  the  CONSISTS  or  CONTAINED  parameter  must  be 
used  In  conjunction  with  this  command. 

114 

VLIST : 

ONLY  SINGLE  VALUE  OR  RANGE  ALLOWED  - IGNORED 
Invalid  format  for  specifying  a VALUES  statement.  See 
ESD  TR#  75-88,  vol  II  for  the  correct  format. 

115 

VLIST : 

MIN  NOT  LESS  THAN  MAX  - IGNORED 

If  a number  range  is  specified  the  first  number  must 

be  less  than  the  second  number. 

116 

OTHERS 

VALUES  ONLY  LEGAL  FOR  ELEMENT,  SYSPAR,  OR  ATTRIBUTE- 
VALUE 

Attempt  to  use  a VALUES  statement  for  a name  which  Is 
not  an  ELEMENT,  SYSTEM-PARAMETER  or  ATTRIBUTE-VALUE. 

117 

OTHERS : 

DIFFERENT  VALUES  ALREADY  GIVEN 

Attempt  to  assign  a second  value  for  a given  object. 
Thts  statement  Is  Ignored. 
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Number 

Subroutine 

j 

Error  Message 

1 

118 

SYSNL; 

INVALID  SYSPAR  GIVEN 

Error  encountered  in  us\ng  a SYSTEM-PARAMETER  in  a given 
statement.  Interpretation  of  rest  of  statement  becomes 
confused. 

E 

119 

SYSNL: 

SYS PAR  MUST  BE  GREATER  THAN  ZERO 
Attempt  to  use  zero  as  a SYSTEM-PARAMETER. 

120 

SNAMET: 

NAME  ALREADY  USED  IN  DIFFERENT  CONTEXT 

Attempt  to  use  a name  in  a context  which  conflicts  in 

the  way  It  has  previously  been  used. 

121 

MAINRCOM: 

NAME  NOT  FOUND  IN  DATA  BASE  - 

Attempt  to  access  information  for  a name  not  defined 
tn  the  data  base. 

1 

122 

MAINRCOM: 

INVALID  TYPE  OF  COMMENT  ENTRY  - 

Attempt  to  replace  unrecognizable  comment  entry  statement. 
Probably  a spelling  error. 

I 

123 

MAINRCOM: 

CANNOT  HAVE  THIS  TYPE  OF  COMMENT  ENTRY  - 

Attempt  to  assign  a comment  entry  statement  which  is 

not  legal  for  the  particular  name  typ°. 

i 

i 

124 

REPSET: 

...WITH  THIS  NAME  - 

Used  In  conjunction  withURA123.  Specifies  the  name 
for  which  the  comment  entry  was  used. 

125 

MAINRCOM: 

PROBLEMS  SCANNING  INPUT  FILE  - MUST  ABORT 
Incorrect  format  of  file  used  for  input.  See  command 
description  for  correct  format. 

► 

126 

REPSET: 

WARNING  - THERE  IS  NO  COMMENT  ENTRY  TO  DELETE 
Attempt  to  delete  nonexistent  comment  entry. 

1 1 

127 

PUNSET: 

DESCRIPTION  COMMENT  ENTRY  NOT  FOUND  FOR  : 

Attempt  to  retrieve  nonexistent  DESCRIPTION  statement. 

& 

[; 

128 

PUNSET: 

PROCEDURE  COMMENT  ENTRY  NOT  FOUND  FOR  : 

Attempt  to  retrieve  nonexistent  PROCEDURE  statement. 

* 

129 

PUNSET: 

VOLATILITY  COMMENT  NOT  FOUND  FOR  : 

Attempt  to  retrieve  nonexistent  VOLATILITY  statement. 

130 

PUNSET: 

VOLATILITY-MEMBER  COMMENT  ENTRY  NOT  FOUK'D  FOR  : 
Attempt  to  retrieve  nonexistent  VOLATILITY-MEMBER 
statement. 

131 

PUNSET: 

VOLATILITY-SET  COMMENT  ENTRY  NOT  FOUND  FOR  : 

Attempt  to  retrieve  nonexistent  VOLATILITY-SET  statement. 

L 
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Number 


132 

133 

134 

135 

141 

142 

143 

144 


145 


146 

147 


148 


149 


Subroutine 

PUNSET; 

PUNSET; 

PUNSET: 

MAINPCOil: 

CONROW: 

BETWEN : 

MAINDP: 

DPCOL : 

DPCOL : 

DPCOL : 
SPROW: 

DPROW : 

DPROW : 


Error  Message 

DERIVATION  COMMENT  ENTRY  NQT  FOUND  FOR  ; 

Attempt  to  retrteye  nonexistent  DERIVATION  statement. 

TRUE  WHILE  COMMENT  ENTRY1  NOT  FOUND  FOR  : 

Attempt  to  retrieve  nonexistent  TRUE  WHILE  statement. 

FALSE  WHILE  COMMENT  NOT  FOUND  FOR  : 

Attempt  to  retrieve  nonexistent  FALSE  WHILE  statement. 

NAME  NOT  FOUND  IN  D.B.  : 

Attempt  to  retrieve  information  for  a name  not  defined 
in  the  data  base. 

NAME  NOT  IN  D.B.  - 

Attempt  to  retrieve  information  for  a name  not  defined 
tn  the  data  base. 

THE  TWO  NAMES  ARE  NOT  CONNECTED  IN  THAT  FASHION 
Attempt  to  delete  a relationship,  between  two  names, 
whtch  is  not  defined  in  the  data  base. 

NAME  NOT  IN  D.B.  - 

Attempt  to  retrieve  information  about  a name  which 
Is  not  defined  in  the  data  base. 

TOO  MANY  COLUMNS 

Exceeded  limits  of  the  software  that  produces  the  matrix 
Names  omitted  from  the  matrix  should  be  used  as  input 
to  another  DP  command. 

TOO  MANY  ROWS 

Exceeded  limits  of  the  software  that  produces  the  matrix 
Names  omitted  from  the  matrix  should  be  used  as  Input 
to  another  DP  command. 

SPARSE  MATRIX  SYSTEM  OVERFLOW 

Exceed  limits  of  the  software  that  produces  the  matrix. 
TOO  MANY  ROWS 

Exceeded  limits  of  the  software  that  produces  the  matrix 
Names  omitted  from  the  matrix  should  be  used  as  input 
to  another  DP  command. 

TOO  MANY  COLUMNS 

Exceeded  limits  of  the  software  that  produces  the  matrix 
Names  omitted  from  the  matrix  should  be  used  as  input 
to  another  DP  command. 

SPARSE  MATRIX  SYSTEM  OVERFLOW 

Exceed  limits  of  the  software  that  produces  the  matrix. 
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150 

DPSUM: 

NO  ROWS 

No  relationships  can  be  specified  about  the  names  used 
as'  input,  so  no  matrix  will  he  generated. 

151 

DPSUM: 

NO  COLUMNS 

No  relationships  can  be  specified  about  the  names  used 
as  input,  so  no  matrix  will  be  generated. 

152 

DPSUM: 

SPARSE  MATRIX  SYSTEM  OVERFLOW 

Exceeded  limits  of  the  software  that  produces  the  matrix. 

153 

MAINDP: 

INVALID  INPUT  NAME  TYPE  - 

Attempt  to  use  a name  which  is  not  a PROCESS  name  as 
input  to  the  command. 

154 

MAINDP: 

INVALID  INPUT  NAME  TYPE  - 

Attempt  to  use  a name  which  is  not  a SET,  INPUT,  OUTPUT, 
ENTITY,  GROUP  or  ELEMENT  name  as  input  to  the  command. 

155 

DPSUM: 

INVALID  ROW  TYPE  - SYSTEM  ERROR 

URA  software  error.  Please  notify  persons  maintaining 
URA  should  this  error  occur. 

156 

CNTAND: 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  has  not  been 
defined  in  the  data  base. 

157 

BETWEN: 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  has  not  been  defined 
In  the  data  base. 

158 

UDDERS: 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  has  not  been 
defined  In  the  data  base. 

159 

UDDERS: 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  has  not  been 
defined  in  the  data  base. 

160 

UDDERS : 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  has  not  been 
defined  in  the  data  base. 

161 

UDDERS: 

NO  CONNECTIVITY  EXISTS 

Attempt  to  delete  a relationship  which  does  not  exist 
for  this  name. 

162 

UDDERS : 

DIFFERENT  CONNECTIVITY  IN  DATA  BASE  - NOT  DELETED 
Attempt  to  delete  a relationship  which  is  not  stated 
exactly  as  is  in  the  data  base. 
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Number  Subroutine 

163  UDDERS: 

164  UDDERS: 

165  UDDERS: 

166  UDDERS: 

167  UDDERS: 

168  UDDERS: 

169  UDDERS: 

170  DELSYN: 

171  DELSYN: 

172  DELSYN: 

173  DRIVES: 


Error  Message 
NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is  not  defined 
in  the  data  base. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is  not  defined 
in  the  data  base. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is  not  defined 
in  the  data  base. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is  not  defined 
in  the  data  base. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is  not  defined 
in  the  data  base. 

DIFFERENT  VALUES  IN  DATA  BASE  - NOT  DELETED 
Attempt  to  delete  a number  or  range  of  numbers  that 
was  not  defined  for  the  statement. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is  not  defined 
in  the  data  base. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is  not  defined 
in  the  data  base. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is  not  defined 
In  the  data  base. 

NAME  IS  NOT  A SYNONYM  FOR  THIS  NAME 

Attempt  to  delete  a SYNONYM  relationship  which  is  not 

defined  in  the  data  base. 

USES  INFORMATION  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is  not  specified 
exactly  as  in  the  data  base.  Relationship  is  not 
deleted. 
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174  DRIVES: 

175  DRIVES: 

176  DRIVES: 

177  DRIVES: 

178  HAPPNS : 

179  DRIVES: 

180  HAPPNS: 

181  DISCON: 

182  DISCON: 

183  DISCON: 

184  ATVLST : 

185  ATVLST: 


Error  Message 

WARNING  - "USING"  INFO  IN  DATA  BASE 
Statement  deleted  although  the  relationship  has  not 
been  specified  exactly  as  in  the  data  base  (the 
"USING"  clause  has  been  omitted). 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is  not  defined 
in  the  data  base. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is  not  defined 
in  the  data  base. 

THESE  TWO  NAMES  NOT  CONNECTED  IN  THAT  WAY 

Attempt  to  delete  a relationship  which  Is  not  defined 

in  the  data  base. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is  not  defined 
In  the  data  base. 

"USES"  NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is  not  defined 
in  the  data  base. 

NAMES  NOT  CONNECTED 

Attempt  to  delete  a relationship  which  is  not  defined 
in  the  data  base. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  Is  not  defined 
in  the  data  base. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is  not  defined 
In  the  data  base. 

NAMES  NOT  CONNECTED 

Attempt  to  delete  a relationship  which  is  not  defined 
in  the  data  base. 

NAME  DOESN'T  HAVE  THIS  ATTRIBUTE 

Attempt  to  delete  a relationship  which  is  not  defined 

In  the  data  base. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is  not  defined 
in  the  data  base. 
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186  ATVLST : 

187  NOCNST: 

188  NOCNST: 

189  NOCNST: 

190  NOCNST: 

191  NOCNST: 

192  CONN: 

193  CONN: 

194  CONN: 

195  SYSVAL: 

196  PLONG: 

197  COMNT : 


Error  Message 

NAME  HAS  NO  ATTRIBUTES 

Attempt  to  delete  ATTRIBUTE  relationship  for  a name 
with  no  ATTRIBUTES. 

SYSPAR  VALUE  IN  DATA  BASE  IS  DIFFERENT  - IGNORED 
Attempt  to  delete  a statement  using  a different  SYSTEM- 
PARAMETER.  Statement  not  deleted. 

WARNING  - SYSPAR  IN  DATA  BASE 

Statement  deleted  though  user  did  not  include  UYSTEM- 
PARAMETER  with  statement. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a CONSISTS  relationship  using  a 
name  not  defined  in  the  data  base. 

CONS I STS /CONTAINED  INFORMATION  NOT  IN  DATA  BASE 
Attempt  to  delete  a CONSISTS  or  CONTAINED  relation- 
ship not  defined  in  the  data  base. 

NO  SYSPAR  IN  DATA  BASE  - IGNORED 
Attempt  to  delete  a relationship  which  is  not  defined 
exactly  in  the  same  way  as  defined  in  the  data  base. 
Statement  not  deleted. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  is  not  defined 
in  the  data  base. 

RELATION  HAS  NO  CONNECTIVITY 

Attempt  to  delete  a CONNECTIVITY  relationship  for  a 
name  with  no  CONNECTIVITY  statements  associated  with  it. 

DIFFERENT  CONNECTIVITY  IN  DATA  BASE 
Attempt  to  delete  a CONNECTIVITY  relationship  not 
defined  exactly  as  is  in  the  data  base.  Statement 
not  deleted. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  which  Is  not  defined 
In  the  data  base. 

COMMENT  NOT  FOUND  ***  SYSTEM  ERROR  *** 

URA  software  error.  Please  notify  persons  maintaining 
URA  should  this  error  occur. 

COMMENT-ENTRIES  NOT  ALLOWED  IN  D URL 
Attempt  to  delete  comment-entry  statements.  This  can 
only  be  done  using  the  DCOM  and  RCOM  commands.  State- 
ment not  deleted. 
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198  COMNT:  EOF  WHILE  LOOKING  FOR  SEMICOLON 

Improper  statement  syntax  has  been  encountered. 
Semicolons  are  needed  to  end  all  URL  statements. 

199  HAPPNS : DIFFERENT  SYSPAR  - NOT  DELETED 

Attempt  to  delete  a HAPPENS  relationship  using  a 
different  SYSTEM-PARAMETER  than  defined  in  the  data 
base.  Statement  not  deleted. 

200  HAPPNS:  INTERVAL  NOT  IN  DATA  BASE 

Attempt  to  delete  a HAPPENS  relationship  using  an 
INTERVAL  not  defined  in  the  data  base. 

201  PLIST:  NAME  NOT  PART  OF  HEADER 

An  illegal  statement  header  has  been  given.  Probably 
a spelling  error.  The  statement  is  ignored. 

202  NLIST:  NAME  PREVIOUSLY  USED  DIFFERENTLY  - IGNORED 

Attempt  to  use  a name  in  a context  different  than  the 
w ay  it  is  defined. 

203  DRIVES:  "USING"  NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a relationship  not  defined  in  the 
data  base. 

204  DEFN:  INVALID  NAME  TYPE 

Attempt  to  assign  a name  type  to  a name  which  is  used 
in  a different  context. 

205  SETSYN:  ALREADY  SYNONYM  FOR  SOMETHING  ELSE 

Attempt  to  assign  a name  to  be  a SYNONYM  for  more  than 
object. 

206  SETSYN:  UNABLE  TO  MAKE  SYNONYM  - TOO  COMPLICATED 

See  Section  10.1  for  explanation  and  solution  to  this 
error. 

207  SETSYN:  CANNOT  BE  MADE  SYNONYM  - DIFFERENT  TYPES 

Attempt  to  assign  a name  as  a SYNONYM  to  a different 
name,  both  with  different  name  types. 

209  SYSNL:  NAME  MUST  BE  INTERVAL 

Attempt  to  use  a name  which  Is  not  an  INTERVAL  in  a 
CONSISTS  statement  for  an  INTERVAL  section. 

210  SYSNL:  INVALID  NAME  TYPE 

Attempt  to  use  a name  in  a context  different  than 
w^y  name  is  defined. 
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211 

OTHERS: 

NAME  MUST  BE  ENTITY  NAME 

Attempt  to  use  a name  in  a context  where  only  m 
ENTITY  name  is  acceptable. 

212 

OTHERS: 

RELATION  ALREADY  EXISTS  BETWEEN  TWO  OTHER  ENTI'IES- 
Attempt  to  specify  the  same  RELATION  for..* --different 
pair  of  ENTITIES.  Different  ENTIT^C-ptffrs  impl» 
different  RELATIONS. 

yr**^** 

213 

OTHERS: 

CAN  ONLY  HAVE  ON  J^fiBflfALITY 

Attempt  to^&pe^ffy a second  CARDINALITY  statement  for 

214 

CONNECTIVITY  ALREADY  GIVEN  FOR  THIS  RELATION 
Attempt  to  specify  a second  CONNECTIVITY  statement 
for  a name. 

215 

OTHERS: 

ALREADY  CONTAINS  WITH  DIFFERENT  SYSTEM  PARAMETER 
Attempt  to  specify  the  same  CONSISTS  statement,  but 
with  two  different  SYSTEM-PARAMETERS. 

216 

OTHERS: 

NAME  MUST  BE  ENTITY  NAME  BEFORE  VIA 

Attempt  to  use  a name  in  a statement  where  only  an 

ENTITY  name  is  allowed. 

217 

OTHERS: 

NAME  MUST  BE  RELATION  AFTER  VIA 

Attempt  to  use  a name  in  a statement  where  only  a 

RELATION  name  Is  allowed. 

218 

OTHERS: 

RELATION  ALREADY  EXISTS  BETWEEN  DIFFERENT  ENTITY 
PAIR 

Attempt  to  specify  the  same  RELATION  for  a different 
pair  ENTITIES.  Different  ENTITY  pairs  Imply  different 
RELATIONS. 

219 

OTHERS: 

NAME  MUST  BE  CONDITION 

Attempt  to  use  a name  in  a statement  where  only  a 
CONDITION  name  is  allowed. 

221 

NLIST : 

TOO  MANY  NAMES  - REST  IGNORED 

Attempt  to  specify  a list  of  names  for  a statement 

where  only  a single  name  Is  acceptable. 

222 

RWLIST : 

NAME  MUST  BE  GROUP  OR  ELEMENT 

Attempt  to  use  a name  in  a statement  where  only  a 

GROUP  or  ELEMENT  name  is  acceptable. 

223 

RWLIST : 

NAME  MUST  BE  SET,  ENTITY,  GROUP,  ELEMENT,  OR  INPUT 
Attempt  to  use  a name  in  a statement  where  only  a 
SET,  ENTITY,  GROUP,  ELEMENT,  or  INPUT  is  acceptable. 
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224 

RWLIST: 

IDENTIFIER  MUST  BE  GROUP  OR  ELEMENT 

Attempt  to  use  a name  in  a statement  where  only  a 

GROUP  or  ELEMENT  name  is  acceptable. 

225 

RWLIST : 

CANNOT  HAVE  KEYWORD  FOR  KEYWORD 

Attempt  to  assign  a KEYWORD  to  a KEYWORD  name. 

226 

RWLIST: 

ONLY  RELATIONS  AND  SEC'S  CAN  BE  MAINTAINED 
Attempt  to  use  a URL  statement  in  the  wrong  context. 

227 

RWLIST: 

PD  CANNOT  BE  RESPONSIBLE  FOR  PD 
Attempt  to  assign  a RESPONSIBLE -USER 
to  a USER  . name. 

228 

RWLIST: 

CANNOT  HAVE  SECURITY  FOR  SECURITY 

Attempt  to  assign  a SECURITY  statement  to  a SECURITY 

name. 

22S 

RWLIST: 

CANNOT  HAVE  SOURCE  FOR  SOURCE 

Attempt  to  assign  a SOURCE  to  a SOURCE  name. 

230 

RWLIST: 

SSC  MUST  BE  SSC,  GROUP,  OR  ELEMENT 

Attempt  to  define  a name,  which  is  not  a GROUP  or 

ELEMENT,  as  SUBSETTING-CRITERIA  for  a SET  name. 

231 

RWLIST: 

SYNONYMS  ONLY  APPLIED  TO  FIRST  NAME 

Attempt  to  assign  a SYNONYM  to  more  than  one  name. 

The  SYNONYM  is  given  only  to  the  first  name. 

232 

APPLES : 

APPLIES  STATEMENT  ILLEGAL  WITH  THIS  NAME  TYPE 
Attempt  to  use  APPLIES  statement  for  a name  which  is 
not  a KEYWORD,  MAILBOX,  SECURITY  or  SOURCE. 

233 

DEFN: 

TOO  MANY  NAMES  IN  DEFINE  HEADER  - REST  IGNORED 
Exceeded  50  name  limit,  remaining  names  should 
be  given  in  another  statement. 

234 

OPTRW: 

NAME  MUST  BE  PROCESS 

Attempt  to  use  a name  in  a wrong  context.  Only  a 
PROCESS  name  can  be  used  in  this  context. 

235 

OPTRW: 

NAME  MUST  BE  ELEMENT,  GROUP,  ENTITY,  OR  SET 
Attempt  to  use  a name  in  wrong  context  for  an  UPDATES 
relati onshlp. 

236 

OPTRW: 

MUST  BE  ELEMENT,  GROUP,  INPUT,  ENTITY,  OR  SET 
Attempt  to  use  a name  in  wrong  context  for  a USES  or 
USING  relationship. 

198 


Number  Subrouti ne 

237  USEDTO: 

238  .USEDTO: 

239  USEDTO: 

240  APPLES: 

241  APPLES: 

246  APPLES: 

247  APPLES: 

248  APPLES: 

249  APPLES: 

251  SNAMET: 

252  SETSYN: 

253  RWLIST : 

254  NAMDBK: 

256  CONTND: 


Error  Message 


MUST  BE  PROCESS  NAME 

Attempt  to  use  a name  in  a wrong  context.  On’y  a 
PROCESS  name  can  be  used  in  this  context. 


MUST  BE  ELEMENT,  GROUP,  ENTITY,  OUTPUT,  OR  SET 
Attempt  to  use  a name  in  the  wrong  context  for  a 
DERIVES  relationship. 

MUST  BE  ELEMENT,  GROUP,  ENTITY,  OR  SET 
Attempt  to  use  a name  in  the  wrong  context  for  an 
UPDATE  relationship. 

KEYWORD  CANNOT  APPLY  TO  KEYWORD 

Attempt  to  use  the  APPLIES  statement  in  the  wrong  context. 
MAILBOX  CAN  ONLY  APPLY  TO  PD 

Attempt  to  use  the  APPLIES  statement  in  the  wrong  context. 
SECURITY  CANNOT  APPLY  TO  SECURITY 

Attempt  to  use  the  APPLIES  statement  In  the  wrong  context. 
SOURCE  CANNOT  APPLY  TO  SOURCE 

Attempt  to  use  the  APPLIES  statement  in  the  wrong  context. 
MEMO  CANNOT  APPLY  TO  MEMO 

Attempt  to  use  the  APPLIES  statement  in  the  wrong  context. 
INVALID  SECTION  - WOOPS 

URA  software  error.  Please  notify  persons  maintaining 
URA  should  this  error  occur. 

ATTEMPT  TO  CHANGE  TYPE  WHEN  ALREADY  TYPED 

URA  software  error.  Please  notify  persons  maintaining 

URA  should  this  error  occur. 

SYNONYM  TABLE  OVERFLOW 

Exceeded  URA  limits.  The  user  should  reissue  INPUT4JRL 
command  at  point  In  the  input  file  where  this  error 
occurred. 

INVALID  STATEMENT  NUMBER 

URA  software  error.  Please  notify  persons  maintaining 
URA  should  this  error  occur. 

CANNOT  CREATE  SYNONYM 

URA  software  error.  Please  notify  persons  maintaining 
URA  should  this  error  occur. 

INVALID  SECTION 

URA  software  error.  Please  notify  persons  maintaining 
URA  should  this  error  occur. 
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257  CONTND: 

258  CONTND: 

259  CONTND: 

263  OPTRW: 

264  SYNTH: 

265  HAPENS: 

266  ILLST: 

267  ILLST: 

268  USEDTO: 

269  NLIST : 

270  INPAR: 

271  MAINCNC: 


MUST  BE  GROUP,  INPUT,  OUTPUT,  OR  ENTITY 

Attempt  to  use  the  CONTAINED  relationship  in  a wrong 

context. 

MUST  BE  SET 

Attempt  to  use  the  CONTAINED  relationship  in  a wrong 
context.  INPUTS,  OUTPUTS  and  ENTITIES  can  only  be 
CONTAINED  In  a SET. 

MUST  BE  GROUP,  INPUT,  OUTPUT,  OR  ENTITY 
Attempt  to  use  a name  in  the  wrong  context  for  a 
CONTAINED  relationship. 

MUST  BE  ELEMENT,  GROUP,  OUTPUT,  ENTITY,  OR  SET 
Attempt  to  use  a name,  defined  to  be  something  else, 
as  a SYSTEM-PARAMETER. 

NAME  MUST  BE  SYSPAR 

Attempt  to  use  a name,  defined  to  be  something  else, 
as  a SYSTEM-PARAMETER. 

SAME  THING,  SAME  INTERVAL,  DIFFERENT  SYSPAR 
Attempt  to  specify  same  relationship  though  different 
SYSTEM-PARAMETER.  Not  allowed. 


ILLEGAL  STATEMENT  IN  THIS  SECTION 

Attempt  to  use  a URL  statement  in  a wrong  context. 

See  esd  tr  # 75-88,  vol  ii  for  where  this  state- 
ment may  be  used. 

NO  CURRENT  SECTION 

Attempt  to  use  an  illegal  section  header  statement. 

See  ssd  tr  # 75-88,  vol  ii  for  list  of  legal  sections. 

NAME  MUST  BE  SET,  ENTITY,  GROUP,  ELEMENT,  OR  INPUT  / 

Attempt  to  use  a frame  1 n the  wrong  context  for  a 
USES  relationship.  i 

NAME  LIST  TOO  LONG,  REST  IGNORED 

Limit  of  50  names  has  been  exceeded.  Remaining  names 

should  be  given  in  another  statement. 

ERROR  OPENING  DATA  BASE  - MUST  ABORT 
Attempt  to  use  an  Inconsistent  data  base.  No  process- 
ing can  be  done  on  it. 

NAME  NOT  IN  D.B.  - 

Attempt  to  retrieve  information  for  a name  not  defined 
In  the  data  base. 
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272  CNCBLD: 

273  CNCBLD: 

274  CNC  LD: 

275  CNCBLD: 

276  CNCBLD: 

277  CNCBLD: 

278  CNCBLD: 

279  CNCSUM: 

280  CNCSUM: 

281  CNCSUM: 


Error  Message 

TOO  MANY  ROWS  - STOPPING  HERE 

Exceeded  limits  of  software  that  produces  the  matrix. 
Names  omitted  from  the  matrix  should  be  used  as  input 
to  another  CNC  command. 

NAME  DOESNT  CONSIST  OF  ANYTHING  - 

No  information  can  be  presented  for  this  name  n the 

matrix. 

TOO  MANY  LEVELS  - LOWER  LEVEL  STUFF  IGNORED 

Too  many  levels  of  CONSISTS  information  to  be  presented. 

♦♦♦THE  FOLLOWING  NAMES  ARE  INVOLVED  IN  A LOOP: 

This  problem  should  be  corrected  by  modifying  the 
CONSISTS  statements  for  these  names. 

TOO  MANY  LEVELS  - LOWER  LEVEL  STUFF  IGNORED 

Too  many  levels  of  CONSISTS  information  to  be  presented. 

TOO  MANY  !*  INS  - STOPPING  HERE 
Exceeded  V.».  „s  of  software  that  produces  the  matrix. 
Names  omitted  '*om  the  matrix  should  be  used  as  input 
to  another  Cr1  ommand. 

SPARSE  MATRIX  OVERFLOW  - STOPPING  HERE 

Exceeded  limits  of  software  that  produces  the  matrix. 

***N0  COLUMNS,  OR  NO  ROWS  - STOPPING 

No  relationships  can  be  specified  about  the  names  used 

as  input,  so  no  matrix  will  be  generated. 

LESS  THAN  2 ROWS,  NO  SIMILARITY  MATRIX 

Not  enough  information  is  available  to  generate  a matrix. 

SPARSE  MATRIX  OVERFLOW  - STOPPING 

Exceeded  limits  of  software  that  produces  the  matrix. 


301  IDENTR:  ♦♦♦TOO  MANY  COLUMNS  — MUST  STOP  HERE  *** 

Exceeded  limits  of  software  that  produces  the  matrix. 
Names  omitted  from  the  matrix  should  be  used  as  input 
to  another  El  command. 


302  IDENTR: 


303 


IDENTR: 


♦♦♦TOO  MANY  ROWS  — MUST  STOP  HERE  *** 

Exceeded  limits  of  software  that  produces  the  matrix. 
Names  omitted  from  the  matrix  should  be  used  as  Input 
to  another  El  command. 

♦♦♦MATRIX  OVERFLOW  — MUST  STOP  HERE  *** 

Exceeded  limits  of  software  that  produces  the  matrix. 
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304  I DENT R:  THE  FOLLOWING  NAMES  DO  NOT  IDENTIFY  ANYTHING: 

No  information  can  be  presented  In  the  matrix  for 
these  names. 

305  IDENTC:  ***  TOO  MANY  COLUMNS  — MUST  STOP  HERE  *** 

Exceeded  limits  of  software  that  produces  the  matrix. 
Names  omitted  from  the  matrix  should  be  used  as  input 
to  another  El  command. 

306  IDENTC:  ***  TOO  MANY  ROWS  — MUST  STOP  HERE  *** 

Exceeded  limits  of  software  that  produces  the  matrix. 
Names  omitted  from  the  matrix  should  be  used  as  input 
to  another  El  command. 

307  IDENTC:  ***  MATRIX  OVERFLOW  — MUST  STOP  HERE  *** 

Exceeded  limits  of  software  that  produces  the  matrix. 

308  IDENTC:  THE  FOLLOWING  NAMES  ARE  NOT  IDENTIFIED  BY  ANYTHING: 

No  information  can  be  presented  in  the  matrix  for 
these  names. 

309  CONROW:  ***  TOO  MANY  COLUMNS  — MUST  STOP  HERE  *** 

Exceeded  limits  of  software  that  produces  the  matrix. 
Names  omitted  from  the  matrix  should  be  used  as  input 
to  another  CM  command. 

310  CONROW:  ***  TOO  MANY  ROWS  — MUST  STOP  HERE  *** 

Exceeded  limits  of  software  that  produces  the  matrix. 
Names  omitted  from  the  matrix  should  be  used  as  input 
to  another  CM  command. 

311  CONROW:  THE  FOLLOWING  ARE  NOT  CONTAINED  IN  ANYTHING: 

No  Information  can  be  presented  in  the  matrix  for  these 
names. 

312  CONROW:  ***  MATRIX  OVERFLOW  — MUST  STOP  HERE  *** 

Exceeded  limits  of  software  that  produces  this  matrix. 

313  CONCOL:  ***  TOO  MANY  ROWS  — MUST  STOP  HERE  *** 

Exceeded  limits  of  software  that  produces  the  matrix. 
Names  omitted  from  the  matrix  should  be  used  as  input 
to  another  CM  command. 

314  CONCOL:  ***  TOO  MANY  ROWS  — MUST  STOP  HERE  *** 

Exceeded  limits  of  software  that  produces  the  matrix. 
Names  omitted  from  the  matrix  should  be  used  as  input 
to  another  CM  command. 

315  CONCOL:  THE  FOLLOWING  DO  NOT  CONSIST  OF  ANYTHING: 

No  CONSISTS  statements  have  been  used  in  conjunction 
with  the  names  listed. 


20? 


1 


Number  Subroutir 2 Error  Message 

316  C0NC01:  ***  MATRIX  OVERFLOW  — MUST  STOP  HERE  *** 

Exceeded  limits  of  softvtare  that  produces  this  matrix. 

317  CHKREL:  NAME  ALREADY  USEO  IN  DIFFERENT  CONTEXT 

Attempt  to  use  a name  In  a context  different  than 
initially  defined  and  used. 


10.  How  to  Correct  Errors 


Once  error  diagnostics  are  generated,  there  must  be  some  metho<  to  deal 
with  them.  When  the  errors  are  caused  by  problems  in  generating  a report, 
no  action  nead  be  taken  as  no  harm  will  come  to  the  data  base.  The  Report 
Command  can  simply  be  restated  in  correct  format  to  solve  the  problem.  If, 
however,  an  error  is  encountered  in  making  modifications  to  the  data  base 
(via  Modifier  Conronds)  then  some  immediate  action  should  be  taken  if  the 
user  desires  to  maintain  a correct  and  complete  user  requirement. 


The  errors  discovered  in  making  modifications  to  the  data  base  can  be 
"Input  Errors"  which  are  errors  discovered  byURA  in  its  attempt  to  process 
the  information  needed  to  update  the  data  base.  All  these  errors  are 
specified  by  one  or  more  URA  error  messages  and  in  ninety  percent  of  the 
cases  these  errors  occur  in  the  process  of  using  the  INPUT-URL  command. 

The  errors  discovered  in  the  user  requirement  by  the  user  are 

called  "Logical  Errors."  No  error  diagnostics  were  generated  byURA  to 
denote  that  an  error  had  occurred.  If  a name  was  misspelled  in  the  input 
information  used  for  INPUT-URL,  the  name  could  be  legal  byURLAJRA  conven- 
tions yet  not  correct  from  the  user's  standpoint.  "BATCH"  and 

"BATHC"  would  be  perfectly  acceptable  to  URA  but  not  to  the  user. 

The  following  two  sections  deal  with  aiding  the  user  in 

correcting  both  Input  Errors  and  Logical  Errors  should  they  occur.  Treat- 
ment of  the  methodology  is  still  at  a high  level  and  no  attempt  is  made  to 
present  procedures  of  correcting  all  possible  errors. 


10.1  Input  Errors 

As  stated  before,  all  input  errors  cause  URA  error  diagnostics  to  be 
printed.  They  are  a few  classes  of  errors  which  happen  again  and  again 
and  so  will  be  described  below. 

Inconsistent  Data  Base 


This  error  is  usually  identified  by  getting  the  URA  error:  "URA094: 

INSYNU:  ERROR  OPENNING  DATA  BASE."  You  might  get  this  error  after 

Issuing  a URA  Modifier  or  Report  Conmand  and  it  specifies  that  the 
contents  of  the  file  you  are  using  as  a URA  data  base  cannot  be  accessed 
by  the  URA  software.  There  are  several  possible  reasons  for  getting  this 
error: 


i)  The  user  has  attempted  to  use  a 
dataset  as  a database  file,  i.e.. 
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the  dataset  being  used  in  the  SET  DB 
command  was  not  created  and 
initialized  as  a URA  database.  See 
Section  2 of  this  paper  for 
requirements  for  a database.  If 
this  is  the  problem  and  the  user  is 
still  in  URA  mode,  the  following 
sequence  of  commands  should  be 
given : 

! (ATTN  Interrupt) 

DELETE  dataset-name. data 

EXEC  NEWDB  ' dataset -name. database' 

EXEC  CLI 

SET  DB=data set- name. database 

where  'dataset-name*  is  the  name  of  the  database 
to  be  accessed. 

ii)  If  the  error  is  not  a result  of  the  above, 
and  information  has  been  previously  stored  in  the 
database,  then  there  is  probably  no  way  to  recover 
it  unless  the  user  has  made  a copy  of  the  database 
by  issuing: 

COPY  dbname. database  SAVE. DATABASE 

if  an  inconsistency  error  has  been  encountered, 
the  user  may  restore  the  database  to  the  state  it 
was  in  when  the  COPY  command  was  issued  by: 

DELETE  database-name. database 

COPY  SAVE. DATABASE  database-name. database 

The  "SAVE. database”  may  then  be  destroyed  if  no 
longer  needed.  This  error  can  occur  if  TSO 
crashes  or  information  from  another  dataset  is 
copied  into  the  database  file. 


URL  Statement  Error 

These  errors  account  for  ninety  percent  of  the 
errors  encountered  when  inputting  information  into 
the  database  via  INPUT— URL.  These  errors  are 
caused  by  improper  use  of  URL  statements  according 
to  the  rules  specified  in  the  URL  Users  Manual 
(ESD/MCI  TR  # XXXXXXXXXX) . An  occurrence  of  any 
of  these  errors  result  in  the  statement,  where  the 
error  occurred  to  be  ignored  by  the  system. 
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The  character  printed  by  URA  is  usually  fairly  close  in  pointing  out 
where  the  error  occurred.  Some  of  the  more  common  errors  (and  solutions) 
are  presented  here  in  hopes  that  the  users  will  be  able  to  apply  the 
methods  of  solving  these  errors  to  their  own,  specific  needs. 

1 ) Syntax  Errors 

Those  errors  are  often  encountered  through  misspellings, 
improper  format  of"  the  statement  or  improper  usage  of  PSL 
reserved  words.  URA  usually  generates  either  of  the  two  error 

messages : 

URA010: REDUCE:  NO  APPLICABLE  PRODUCTION-SYNTAX  ERROR-START  SKIPPING 


URA011  -.STACK:  ILLEGAL  SYMBOL  PAIR-SYNTAX  ERROR-START  SKIPPING 

For  example,  if  you  misspell  the  RECEIVES  statement: 

RECIEVES  FOLDER-A, FOLDER- B; 

URA  will  react  with  the  URA010  error  message  and  skip  that 
statement  to  go  on  to  the  next.  There  are  some  further  problems 
that  can  occur  then.  If  the  error  occurred  in  a header  state- 
ment, such  as  PROCESS,  etc.,  then  the  header  statement  is  skipped 
and  all  statements  intended  to  be  related  to  the  header  statement 
will  be  related  to  the  previous  header  statement.  Take  the  example: 

GROUP:  Gl; 

CSTS:  El,  E2,  G2; 

PROCCESS:  PI; 

RCVS:  II,  12; 

SUBPARTS  P2 , P3; 

ELEMENT  El,  E2 ; 

PROCESS  has  been  misspelled  which  results  in  having  that  header 
statement  skipped.  All  the  statements  following  this  header 
are  related  to  the  previous  header  which  leads  to  more  problems 
since  statements  which  can  only  be  associated  to  a PROCESS  are 
bring  given  to  a GROUP  name.  More  errors  will  occur  from  this 
resulting  in  the  PROCESS,  RCVS  and  SUBPARTS  statements  not  being 
entered  into  the  data  base.  To  correct  this  error,  the  state- 
ments that  v/ere  omitted  could  tie  entered  by  another  INPUT-PSL 
conmnnd.  A far  more  serious  problem  occurs  if  the  "previous" 
header  was  also  a PROCESS  in  our  particular  example: 


PROCESS  PX; 

RCVS:  11,13; 

Gi.NS : 01,02; 

PKOCCESS  PI ; 

RCVS  II,  12; 

SIJI31  ARTS  P2,P3; 

ELEMENT  El ,E2; 

If  this  wore  the  case,  then  only  one  error  would  he  caught  (the 
misspelled  "PRGCCLSS")  and  the  trailing  RCVS  and  SUBPARTS 


statements  would  be  given  to  PROCESS  PX.  If  this  mistake  was 
discovered,  the  user  would  have  to  delete  the  t.wo  statemorts 
from  PX  and  tnen  re input  the  information  for  PI: 


DrLETE-URL 

PROCESS  PX; 

RCVS  II  ,12; 

SOU PARIS  P2.P3; 

LOF 

INPliT-URL  UPDATE 

PROCESS  PI  ; 

RCVS  11,1?; 

SI  111  PARTS  P2,P3; 

LOF 

i i ) Illegal  Statement 

This  error  is  designated  by  the  PSA  error: 

URA266: ILLST : ILLEGAL  STATEMENT  IN  THIS  SECTION 

This  error  can  be  caused  by  simply  using  a statement  that  is  not 
allowed  i ,r  that  particular  section.  Using  a CONSISTS  statement 
in  ci  PROCESS  section  would  obviously  generate  this  error.  The 
other  case  occurs  when  an  error  is  made  in  a header  section  state- 
ment and  .ill  the  following  statements  might  be  incompatible  with 
the  previous  ncaoer  section  name.  Note  that  whenever  this  error 
is  encountered,  the  statement  is  not  put  into  the  data  base. 

i i i ) 111  egg 1 Header  Statement 

If  an  error  occurs  in  a header  statement  and  PSA  is  able  to 
identify  it  as  a header  statement,  the  following  error  will  be 
given: 

URA266: ILLST : INVALID  HEADER  STATEMENT-STATEMENTS  WILL  EF  IGNORED 

This  means  that  all  the  statements  up  to  the  next  header  statement 
will  be  ignored  and  not  put  into  the  data  base.  All  the  statements 
ignored  must  be  reinputted  to  another  command  to  be  put  into  the 
date  base. 

i v ) Inp i it_ Line  T no  to ng_ 

If  a number  -if  URL  statements  are  used  on  one  line  of  the  input 
file  <.r  URI  s ...stement  is  very  long,  it  may  run  over  the  12 
column  restriction.  Should  this  occur,  usual  ly  URA010  orURAOll 
will  hr  generated  specifying  that  improper  syntax  has  been 
countered.  Note  that  no  error  message  is  generated  for  the  fact 
that  the  statement  runs  over  the  72  column  restriction.  Errors 
are  encountered  because  anything  over  column  72  is  ignored  no 
matter  what  type  of  character  it  is  and  so  names  may  be  truncated 
or  a semicolon  is  missing. 
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will  generate  the  error.  P2  is  implicitly  defined  to  be  a 
PROCESS  just  in  the  context  that  it  is  used  in  the  second 
statement  and  also  have  a relationship  with  G1 ; now  LONG- 
PROCESS-NAME  is  defined  and  has  relationships  formed  with  P3 
and  P4.  In  the  last  statement,  an  attempt  was  made  to  make 
P2  and  LONG-PROCESS-NAME  the  same  PROCESS  and  the  error  is 
generated.  The  whole  problem  could  have  been  avoided  if  the 
user  maintained  the  convention  of  issuing  SYNONYM  statements 
directly  after  the  header  statement  as  shown  below: 

GROUP  Gl; 

USED  BY  P2; 

PROCESS  LONG-PROCESS-NAME; 

SYNONYM  P2; 

SUBPARTS  P3;P4; 

If  the  statements  had  been  inputted  in  this  manner,  LONG-PROCESS- 
NAME  would  not  have  had  any  relationships  formed  with  other 
names  (P3  and  P4  in  the  previous  example)  and  the  asslgnement  of 
P2  as  a SYNONYM  would  have  been  successful. 

Since  the  error  does  occur,  there  exists  a method  of  correcting 
this  problem.  First,  all  information  about  one  of  the  names,  P2 
or  LONG-PROCESS-NAME .must  be  retrieved  and  then  that  name  deleted 
from  the  data  base.  The  information  can  then  be  editted  to  be 
acceptable  by  URA  and  reinputted  via  INPUT-URL  . 

FPS  N=P2  P= PUNCH 
DELETE  N=P2 

I 

• 

EDIT  PUNCH 

CHANGE  1 /P 2/LONG- PROCESS -NAME/ 

1.5  SYNONYM  P2; 

SE 

EXEC  CLI 

INPUT-URL  I = PUNCH  U 

In  this  way,  all  information  about  P2  is  given  to  LONG-PROCESS- 
NAME  and  P2  is  assigned  as  a SYNONYM  if  future  references  to  the 
name  are  necessary.  Really,  it  would  have  been  much  easier  if  you 
maintain  the  convention  of  assigning  SYNONYMS  directly  after  the 
header  statement. 

vl i ) Names  Used  in  Wrong  Context 

This  type  of  error  accounts  for  the  majority  of  different  error 
messages  presented  in  Section  9. 

URA202.-NLIST:  NAME  PREVIOUSLY  USED  DIFFERENTLY- IGNORED 

and, 

URA222:RWLIST:  NAME  MUST  BE  GROUP  OR  ELEMENT 
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ari  examples  of  diagnostics  presented  for  this  type  cr  error. 

Th..*  statement  will  be  ignored  and  the  only  way  to  resilve  the 
pnblem  is  to  reinput  the  information  in  an  acceptabl  » format. 

vi i i ) Br making  Section /Statement  Rules 

Sereral  error  messages  can  be  generated  by  attempting  to  break 
the  rules  set  forth  in  ESD  TR  # for  statements 

within  a particular  section.  In  using  the  PART  statement,  for 
example,  an  object  may  be  PART  of  only  one  object  and  failure  to 
comply  with  this  rule  will  result  in: 

URA061 rRWLIST : ALREADY  PART  OF  SOMETHING  ELSE 

or  some  analogous  URA  error  message.  These  error  checks  are 
made  to  enforce  tne  rules  set  forth  in  Working  Paper  No  68  and 
ensure  that  the  user  reauirement  is  still  meaningful.  Other 
messages  presented  for  this  type  of  error  are: 

URA21 4:0THEio:  CONNECTIVITY  ALREADY  GIVEN  FOR  THIS  RELATION 

or, 

LTRA060: APPLES:  SECOND  MAILBOX  FOR  PD  ILLEGAL 

If  the  user  wishes  to  replace  the  information  stated  in  the  data 
base,  say  replace  tne  MAILBOX  for  a _ user  , the  relation- 

ship should  be  deleted  via  DELETE-URL  and  then  input  the  correct 
Information  using  the  INPUT-URL  command. 


10.2  Logical  Errors 

These  errors  occur  when  inputting  information  into  the  data  base  (as  input 
errors  do),  but  no  diagnostics  are  given  in  the  AS-IS  SOURCE  LISTING.  These 
errors  might  be  detected  by  scanning  the  complete  list  of  names  in  the  data 
base  (NAME-GEN)  and  the  complete  user  requirement  (FORMATTED-PROBLEM- 
STATEMENT).  These  errors  can  also  be  aetected  when  reviewing  the  contents 
of  any  of  the  other  reports  available  on  URA. 

Misspelled  Names 

A simple  spelling  error  can  result  in  two  names  which  look  very  similar, 
but  which  are  treated  as  two  different  objects  in  the  data  base. 

1)  Fo-*  example,  if  we  used  the  name,  "CALENDAR-DAY"  to  specify 
a particular  INTERVAL  in  the  data  base  and  then  used  "CALENDAR- 
DAYS"  in  the  statements: 

INTERVAL:  CALENDAR-week; 

CONSISTS:  7 CALENDAR  DAYS; 

the  two  names  are  completely  different  objects  (to  URA).  URA 
does  not  know  that  you  have  made  a spelling  error  anc  it  is  up 
to  you  to  detect  and  correct  it,  which  can  be  done  ir.  the 
following  manner: 
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FPS  N= CALENDAR- DAYS  P= PUNCH 
DELETE  N=CALENDAR-DAYS 

t 

EDIT  PUNCH 

CHANGE  1 /CALENDAR-DAYS/CALENDAR-DAY/ 

SE 

EXEC  CLI 

INPUT-URL  I=PUNCH  U 

All  information  given  about  CALENDAR-DAYS  is  transferred  to 
CALENDAR-DAY  and  then  CALENDAR-DAYS  is  deleted  from  the  data  base. 
If  it  is  desirable  to  use  plural  forms  of  the  names  in  the  data 
base  as  SYNONYMS,  this  can  be  done  in  a DESIGNATE  statement: 

INPUT-URL 

DESG  CALENDAR-DAYS  SYNONYM  CALENDAR-DAY; 

EOF 

ii)  Since  names  can  consist  of  letters  or  numbers,  another  common 
misspelling  error  Is  to  substitute  the  letter  “0"  with  the 
number  "0".  It  is  often  very  difficult  to  detect  this  and  so 
there  appears  to  be  two  names,  spelled  exactly  the  same  in  the 
data  base.  This  can  be  corrected  in  the  same  way  as  the  previous 
problem. 

iii)  When  the  spelling  error  only  involves  one  name  (if  TIME-CARD  was 
spelled  TIMECARD  in  all  instances)  then  this  problem  could 
easily  be  solved  by  using  the  RENAME  command: 

RENAME  $=TIMECARD  N=TIME-CARD 


If  both  TIME-CARD  and  TIMECARD  are  defined  in  the  data  base, 
then  the  same  procedure  used  to  change  CALENDAR-DAYS  must  be 
performed. 


Redundant  Objects 


Another  error  which  occurs  quite  frequently  is  to  define  one  object  by 
two  different  names,  not  realizing  that  they  are  truly  representing  the 
same  thing.  EMPLOYEE-RECORD  and  EMPLOYEE-DATA  may  be  defined  separately 
in  the  data  base,  but  represent  the  same  thing.  To  resolve  this  redundancy, 
we  must  combine  the  information  for  these  two  names.  If  the  two  names  have 
the  same  name  type  associated  with  them  (say  ENTITY),  then  fewer  problems 
are  encountered.  If  they  are  of  different  name  types,  the  CHANGE-TYPE 
conmand  must  be  used.  Now  the  names  can  be  defined  to  be  used  synonymously 
with  each  other  by  the  following  procedures. 

FPS  N= EMPLOY EE- DATA  P= PUNCH 

DELETE  N= EMPLOYEE- DATA 

t 

EDIT  PUNCH 

CHANGE  1 /DATA/RECORD/ 

1.5  SYNONYM:  EMPLOYEE-DATA 

SE 

EXEC  CLI 

INPUT-URL  I=PUNCH  U 
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Missing  Semi  olons 

Most  often,  missing  semicolon  can  be  detected  as  a syntax  err>r  (as 
^escribed  in  Section  10.1).  There  is  one  particular  case  where  a missing 
semicolon  wo  :ld  not  generate  any  error  message: 

PROCES  i PI ; 

DESCRIPTION; 

THIS  IS  A DESCRIPTION  COMMENT  ENTRY  THAT  IS  MISSING 
TIE  SEMICOLON. 

RCVS  I M2; 

GENS  )1 ,02; 

What  happens  here  is  that  the  RCVS  statement  becomes  part  of  the  DESCRIPTION 
conment  entry.  A semicolon  was  omitted  in  terminating  the  lines  we  intended 
as  the  conment  entry,  but  URA  simply  searches  for  the  first  semicolon  to 
signify  the  end  of  the  comment  entry.  To  solve  this  problem  the  DESCRIPTION 
statement  must  be  replaced  and  the  RCVS  statement  must  be  added  to  the 
data  base: 

PCOM  N=P 1 DESC  P= PUNCH 

EDIT  PUNCH 
DELETE  5 
SE 

EXEC  CLI 

RCOM  F= PUNCH 
INPUT -URL  U 
PROCESS  PI; 

RCtfS  II,  12; 

EOF 

Correctness  and  Completeness 

For  the  most  part,  it  is  up  to  the  user  to  maintain  correctness 

of  the  user  requirement  and  URA  maintains  correctness  of  the  data  base. 

The  user  has  the  ability  to  do  this  through  usage  of  the  DELE7E- 

URL  and  INPUT -URL  commands.  Completeness  can  also  be  determined  by  the 
user  or  improved  through  use  of  the  INPUT-URL  command. 
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APPENDIX  A - URA  Special  Procedures 


This  appendix  consists  of  sets  of  procedures 
to  perform  specific  operations  dealing  mainly  with 
modification  of  the  URA  database.  Procedures  are 
presented  to  aid  in  using  each  of  the  modifier 
commands: 

CHANGE-TYPE 

DELETE 

DELETE-COMMENT- ENTRY 

DELETE-URL 

INPUT-URL 

RENAME 

REPLACE-COMMENT-ENTRY 


and  to  aid  in  resolving  specific  problems  due  to 
logical  errors. 

A few  of  the  conventions  used  for  these 
procedures  are  listed  below: 

1.  T. DATA  is  a dataset  which  is  used  to 
contain  information  specified  by  the  user.  If  the 
dataset  is  to  be  used  more  than  once  in  a given 
terminal  session,  the  old  input  lines  should  be 
deleted  using  the  DELETE  command  of  EDIT  before 
new  input  lines  are  specified. 

2.  PUNCH. DATA  is  a dataset  used  to  contain 
information  supplied  by  the  PUNCH  output  of  any 
URA  command.  If  the  dataset  is  to  be  used  more 
than  one  in  any  given  terminal  session,  URA  will 
write  over  any  information  left  from  previous 
commands. 
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3.  All  the  words  specified  in  lower  case 
represent  names  or  information  which  must  be 
replaced  by  the  users  for  their  particular 
implementation  of  the  procedure. 

U.  All  words  specified  in  uppercase  are 
information  which  must  be  stated  exactly  as  shorn 
(except  for  substitution  of  legal  abbreviations) 
for  the  procedure  to  work  correctly. 

5.  These  procedures  assume  the  user  is  in 
URA  mode  when  the  procedure  is  implemented. 

6.  All  URA  commands  are  indented  from  any 
TSO  commands  with  which  they  may  appear.  This 
indentation  is  provided  solely  for  clarity  and  the 
spaces  should  not  be  used  at  the  terminal. 

7.  Some  of  the  procedures  start  with  an 
attention  interrupt  (signified  "J")  to  return  to 
TSO.  In  all  cases,  a FREEALL  should  be  issued 
following  the  interrupt.  The  FREEALL  commands  are 
not  included  in  the  algorithms  for  clarity. 


J 

EXEC  NEWDB  • dfcname. DATABASE* 
EXEC  CLI 

SET  DB=dbname. DATABASE 


i 


2] 
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CHANGE-TYPE  Command  Procedures 

1.  To  change  the  name  type  for  only  one  name  in 
the  database: 

CT  N=name  TYPE= new- name-type 

2.  To  change  the  name  types  of  several  names  in 
the  database  when  the  name  type  are  not  the  same: 

I 

• 

EDIT  T. DATA  NEW 

namel  new- name- type  1 

name 2 new-name-type  2 

• » 

i i 

• • 

namen  new- name- typen 

(blank  line  RETUPN) 

SE 

EXEC  CLI 

CT  FILE=T. DATA 

3.  To  change  the  name  types  of  several  names  to 
the  same  name  type: 

« 

• 

EDIT  T . DATA  NEW 
namel 


* 


* 
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* 

namen 

(blank  line  RETURN) 

SE 

EXEC  CLI 

CT  FILE=T . DATA  TYPE=new-name-type 


DELETE  Command  Procedures 

1.  To  delete  one  name  from  the  database: 
DELETE  N=name 

2.  To  delete  several  names  from  the  database: 

• 

EDIT  T. DATA  NEW 

name  1 

name2 

• 

i 

* 

namen 

(blank  line  RETURN) 

SE 

EXEC  CLI 

DEL  F=T. DATA 


U 
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DELETE-COMMENT-ENTRY  Command  Procedures 


1 • To  delete  one  type  of  comment  entry  for  one 
name  in  the  database: 

DCOM  N=name  comment-entry-parameter 

2.  To  delete  one  type  of  comment  entry  for 
several  names: 

« 

• 

EDIT  T . DATA  NEW 
namel 

• 

t 

« 

namen 

(blank  line  RETURN) 

SE 

EXEC  CLI 

DCOM  F=T. DATA  comment-entry- parameter 

3.  To  delete  two  comment  entry  types  for  several 
names: 

i 

EDIT  T. DATA  NEW 
name  1 

• 


DELETE-URL  Command  Procedures 


1.  To  delete  several  relationships  from  a URA 
database  using  a dataset  as  input: 

I 

EDIT  T. DATA  NEW 

legal  URL  statements 

EOF 

(blank  line  RETURN) 

SE 

EXEC  CLI 
DURL  I=T. DATA 

2.  To  delete  several  relationships  from  a URA 
database  on  an  interactive  basis  (using  the 
terminal) : 

DURL 

| legal  URL  statements 
EOF 
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INPUT-URL  Command  Procedures 


1.  To  input  information  into  a URA  database  using 
the  contents  of  a dataset  as  input:* 


EDIT  T. DATA  NEW  legal  URL  statements 


(blank  line  RETURN) 


EXEC  CLI 

IP  I=T. DATA  UPDATE 

2.  To  interactively  input  information  into  a URA 
database : 


IP  U 


legal  URL  statements 


♦The  user  may  wish  to  save  T. DATA  permanently  in 
this  case. 
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RENAME  Command  Procedures 

1.  To  change  the  name  of  one  name  in  the 
database: 

REN  0=oldname  N=newname 

2.  To  change  the  names  of  several  names  in  the 
database: 

• 

EDIT  T. DATA  NEW 

old  namel  newnamel 

old  name2  oldname2 

t t 

i • 

t t 

oldnamen  newnamen 
(blank  line  RETURN) 

SE 

EXEC  CLI 
REN  I=T. DATA 
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REPLACE- COMMENT -ENTRY  Command  Procedures 

1.  To  completely  change  comment  entry  for  one 
name  in  the  database: 

i 

EDIT  T. DATA  NEW 
name 

comment- entry-type 

| comment  entry  text 

} 

(blank  line  RETURN) 

SE 

EXEC  CLI 

RCOM  I=T. DATA 

2.  To  change  a comment  entry  for  a name  with  an 
edited  version  of  the  same  comment  entry: 

PCOM  N=name  comment-entry-parameter  P= PUNCH. DATA 

t 

EDIT  PUNCH. DATA 

edit  commands  to  change  text 
(blank  line  RETURN) 

SE 

EXEC  CLI 

RCOM  I = PUNCH. DATA 
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APPENDIX  8 - URA  Command  Abbreviations 


This  appendi < presents  all  commands,  and  parameters  to  these  ccnmands, 
for  URA.  It  also  presents  the  acceptable  abbreviations  for  these  commands 
and  parameter  on  the  right  hand  side.  There  are  several  conventions  in 
choosing  these  abbreviations  that  may  aid  the  user: 

1.  For  command  names  that  consist  of  only  one  word,  for  example, 
CONTENTS  or  PICTURE,  the  first  three  or  four  letters  of  the 
name  are  used  as  they  abbreviation.  CONT  is  the  abbreviation 
for  CONTENTS  and  PIC  is  the  abbreviation  for  PICTURE. 

2.  For  most  command  names  that  consist  of  more  than  one  word, 
e.g.,  CONSISTS-MA'i RIX  or  FORMATTED-PROBLEM-STATEMENT,  the 
abbreviation  is  derived  by  using  the  first  letter  from  each 
word  in  the  command  name.  This  gives  us  CM  for  CONSISTS-MATRIX 
and  FPS  for  FORMATTED-PROBLEM-STATEMENT.  This  convention  is 
not  strictly  enforced,  however,  so  that  the  abbreviations  may 
be  more  meaningful.  For  example,  DCOM  is  the  abbreviation  for 
DELETE-COMMENT-ENTRY  which  means  more  than  DCE. 

3.  Abbreviations  are  the  same  for  those  parameters  which  are  used, 
in  the  same  way,  by  several  commands.  The  FILE  parameter  then, 
always  has  an  abbreviation,  F,  allowed  no  matter  which  command 

is  using  it.  Some  of  the  more  common  parameters  are  listed  below: 


Parameter 

FILE 

NAME 

INPUT 

NOPRINT 

PUNCH 


Abbreviation 


4.  Whenever  an  abbreviation  exists  for  a parameter  that  has  a 

"NO"  prefix,  such  as  NOSYNONYMS  or  NOPRINT,  the  abbreviation  is 
always  prefixed  with  "N".  For  example,  NSYN  is  the  abbreviation 
for  NOSYNONYMS  and  NP  is  the  abbreviation  for  NOPRINT. 


Command  Name  Parameters  Abbreviations 


Command  Name  Parameters  Abbreviations 

CHANGE-TYPE  CT 

FILE  F 

NAME  N 

TYPE  T 

CONS I STS -COMP ARI SON  . CNC 

FILE  F 

CONS I STS -MATRIX  CM 

FILE  F 

NAME  N 

CONTAINED  CNTD 

CONSISTS  CSTS 

CONTENTS  CONT 

FILE  F 

NAME  N 


INDEX 

NOINDEX 

LEVELS 

NCFLAG 

NONCFLAG  - 

i 

DATA-BASE-STATISTICS  DBS 

NAMES  ; 

NONAMES 
NUBS 
NONUBS 
NAMNUBS 
NONAMNUBS 


SYNONYMS  SYN 

NOSYNONYMS  NSYN 

DATA-PROCESS  DP 

FILE  F 

NAME  It 

DATA  D 

PROCESS  P 
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Comnand  N me  Parameters 


Abbreviations 


DELETE  DEL 

FILE  F 

NAME  N 

DELETE-COMMENT-ENTRY  DCOM 

DERIVATION  DER 

DESCRIPTION  DESC 

FALSE-WHILE  FW 

PROCEDURE  PRCD 

TRUE-WHILE  TW 

VOLATILITY  VOL 

VOLATILITY-MEMBER  VOLM 

VOLATILITY-SET  VOLS 

FILE  F 

NAME  N 

PRINT 

NOPRINT  NP 

DELETE-PSL  * DPSL 

INPUT  I 

SOURCE  S 

NOSOURCE  NS 

XREF  X 

NOXREF  NX 

DICTIONARY  DICT 

FILE  F 

NAME  N 

INDEX 
NO INDEX 

NUM-SPACE  NS 

DESCRIPTION  DESC 

NODESCRIPTION  NDESC 

KEYWORDS  KEY 

NOKEYWORDS  NKEY 

RESPONSIBLE-PD  RPD 

NORESPONSIBLE-PD  NRPD 

SYNONYMS  SYN 

NOSYNONYMS  NSYN 
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Command  Name 


Parameters 


Abbreviations 


ENTITY-IDENTIFIER  ,EI 

FILE  F 

NAME  N 

IDENTIFIER  I 

ENTITY  E 

FORMATTED-PROBLEM-STATEMENT  FPS 

AMARG  AM 

BMARG  BM 

COMMENT  COM 

NOCOMMENT  NCOM 

CMARG  CM 

DEFINE  DEF 

NODEFINE  NDEF 

DESG  DG 

NODESG  NDG 

EMPTY 
NOEMPTY 

FILE  F 

NAME  N 

HMARG  HM 

INDEX 
NO INDEX 

NEW-LINES  NL 

NONEW-LINES  NNL 

NEW-PAGE  NPG 

NONEW-PAGE  NNPG 

NMARG  NM 

ONE-PER-LINE  OPL 

SEVERAL-PER-LINE  SPL 

PRINT 

NOPRINT  NP 

PUNCH  P 

NOPUNCH 

RNMARG  RM 

SMARG  _ S>1 


Command  N me 


Parameters 


Abbreviations 


FREQUENCY 

FREQ 

HELP 

command -name 

SHORT 

LONG 

INPUT-PSL 

IP 

DBREF 

D 

NODBREF 

ND 

INPUT 

I 

SOURCE 

S 

NOSOURCE 

NS 

UPDATE 

U 

NOUPDATE 

NU 

XREF 

X 

NOXREF 

NX 

KUIC 

FILE 

F 

NAME-GEN 

DIF 

NG 

ATTRIBUTE 

ATTR 

NOATTRIBUTE 

NATTR 

ATTRIBUTE-VALUE 

AHV 

NOATTRIBUTE-VALUE 

NATTV 

CONDITION 

COND 

NOCONDITION 

NCOND 

ELEMENT 

ELE 

NOELEMENT 

NELE 

ENTITY 

ENT 

NOENTITY 

NENT 

EVENT 

EV  . 

NOEVENT 

NEV 

GROUP 

GR 

NOGROUP 

NGR 

2?9 


Command  Name 


Parameters 


Abbreviations 


NAME-GEN  (cont'd) 


INPUT 

INP 

NO INPUT 

NINP 

INTERVAL 

INT 

NO INTERVAL 

NINT 

KEYWORD 

KEY 

NOKEYWORD 

NKEY 

MAILBOX 

BOX 

NOMAILBOX 

NBOX 

MEMO 

NOMEMO 

NMEMO 

OUTPUT 

OUT 

NOOUTPUT 

NOUT 

USER 

NOUSER 

PROCESS 

PROC 

NOPROCESS 

NPROC 

REAL -WORLD-ENTITY 

RWE 

NOREAL -WORLD-ENTITY 

NRWE 

RELATION 

RLN 

NORELATION 

NRLN 

SECURITY 

SEC 

NOSECURITY 

NSEC 

SET 

NOSET 

SOURCE 

SRC 

NOSOURCE 

n'src 

SUBSETTING-CRITERION 

SSCN 

NOSUBSETTING-CRITERION 

NSSCN 

SYNONYMS 

SYN 

NOSYNONYMS 

NSYN 

SYSTEM-PARAMETER 

SYSP 

NOSYSTEM-PARAMETER 

NSYSP 

UNDEFINED 

UNDF 

NOUNDEFINED 

NUNDF 

Command  Ni  me  Parameters  Abbreviations 

NAME-GEN  'cont'd) 

BASIC 

NOBASIC 

EMPTY 

NOEMPTY 

KEY 

IDENTIFIER  ID 

IDENTIFIER-GROUP  IDG 

IDENTIFIER-ELEMENT  IDE 


NONE 

ALL 

ORDER 

PD 

PRINT 

NOPRINT  NP 

PUNCH  P 

NOPUNCH 
TOTAL 

SUBLEVEL  SL 

SUBPARTS-OF  SO 

NAME-LIST  NL 

SYNONYMS  SYN 

NOSYNONYMS  NSYN 

PICTURE  PIC 

DATA  D 

NODATA  ND 

FILE  F 

NAME  N 

FLOW 
NOFLOW 
INDEX 
NOINDEX 
STRUCTURE 


NOSTRUCTURE 
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N5TR 


Command  Name  Parameters 

PRINT-ATTRIBUTE-VALUES 

FILE 

NAME 

PROCESS- INPUT-OUTPUT 
FILE 
NAME 

DESCRIPTION 

NODESCRIPTION 

PROCEDURE 

NOPROCEDURE 

INPUT 

NOINPUT 

OUTPUT 

NOOUTPUT 

NEW- PAGE 

NONEW-PAGE 

PRINT 

NOPRINT 

PUNCH 

NOPUNCH 

EMPTY 

INDEX 

NOINDEX 

PUNCH- COMMENT- ENTRY 

DERIVATION 

DESCRIPTION 

FALSE-WHILE 

PROCEDURE 

TRUE-WHILE 

VOLATILITY 

VOLATILITY-MEMBER 

VOLATILITY-SET 

EMPTY 

NOEMPTY 

FILE 

NAME 


Abbreviations 

PAV 

F 

N 

PRIO 

F 

N 

DESC 

NDESC 

PRCD 

NPRCD 

INP 

NINP 

OUT 

NOUT 

NPG 

NNPG 

NP 

P 


PCOM 

DER 

DESC 

FW 

PRCD 

TW 

VOL 

VOLM 

VOLS 
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Comma nd  Name 

Paraineters 

Abbreviations 

PUNCH-COMMENT-ENTRY  (eont'd) 

PRINT 

NOPRINT 

NP 

PUNCH 

P 

NOPUNCH 

RENAME 

REN 

INPUT 

I 

OLD 

0 

NEW 

N 

REPLACE-COMMENT-ENTRY 

RCOM 

INPUT 

I 

PRINT 

NOPRINT 

NP 

SET 

ECHO 

E 

INPUT 

I 

LINES 

L 

OUTPUT 

0 

PROMPT 

P 

STOP 

STRUCTURE 

STR 

INDENT 

IND 

INDEX 

IND 

NO INDEX 

INPUT 

iNr 

OUTPUT 

OUT 

PROCESS 

PROG 

REAL-WORLD-ENTITY 

RWK 

SUMMARY 

SUM 
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comment  entry 

comment  entry 
statement 

Control  Command 

conversational 

mode 

database 

data  object 

device 

dsname 

ESD  TR# 

ESD  Tk# 

heaaer  section 

input  file 
mode 


Glossary 

The  text  associated  with  a comment  entry  statement. 
DESCRIPTION,  PROCEDURE  and  VOLATILITY  are  examples  of 
comment  entry  statements. 

Any  URL  statement  which  allows  the  contents  of  the  state- 
ment to  be  defined  by  the  user  (as  is  narrative  description) . 
The  DESCRIPTION  and  PROCEDURE  statements  are  examples 
of  this. 

A URA  command  which  passes  control  information  to  URA. 

STOP  and  SET  are  Control  Commands. 

Used  synonymously  with  on-line  mode,.  Refers  to  inter- 
active use  of  the  computer  system  through  a terminal 
device . 

Synonymous  with  "URA  database".  This  is  the  information 
stored  and  retrieved  by  URA  by  means  of  the  Modifier 
and  Report  Commands. 

Any  URA  name  type  that  represents  some  form  of  data. 

SETS,  INPUTS,  OUTPUTS,  ENTITIES,  GROUPS  and  ELEMENTS 
are  all  data  objects  described  by  URL. 

Input-output  peripheral  equipment;  for  example,  a card 
reader,  magnetic  tape  drive,  terminal,  etc. 

Any  legal  dataset  name  that  is  to  be  specified  by  the 
user. 

"URL  User  Manual",  Version  3.0.  This  manual  specifies 
and  defines  all  the  URL  statements  processable  by  URA, 
their  purpose,  syntax,  etc. 

"An  Introduction  to  Computer  Aided  Requirements  Analysis". 

Any  of  the  statements  allowed  in  URL  that  specify  the 
beginning  of  a set  of  statements  describing  the  user 
defined  names  specified  in  this  statement.  See  Appendix 
F of  E3D  TR#  ( ) for  a complete  list  of  all 

section  types. 

Any  dataset  which  contains  data  to  be  used  by  URA  com- 
mands via  INPUT  or  FILE  parameters. 

Term  used  synonymously  with  "processing  mode"  which 
refers  to  a state  where  the  user  has  a particular  set 
of  operations  available  to  perform  required  tasks. 
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Any  URA  command  which  alters  the  contents  of  the  user's 
URA  database. 


Modifier  Command 


name  type  Any  of  the  many  types  of  names  allowed  in  URL  (i.e.,  PROCL.C.C, 

SET,  GROUP,  etc.).  Gee  ESD  TR/M  ),  "URL 

Users  Manual",  Appendix  E for  a list  of  all  possible 
name  types. 

Report  Command  Any  command  available  on  the  URA  system  whose  sole  pur- 

pose is  to  retrieve  information  from  the  user's  URA 
database. 

undefined  name  A name  that  has  been  entered  into  the  URA  database,  but 

has  no  name  type  asspciated  with  it. 

URA  The  User  Requirement  Analyzer.  Synonym  is  "Analyzer". 

Software  package  which  retrieves  and  inputs  information 
to  the  URA  database. 

URA  command  Any  of  the  commands  that  can  be  used  to  operate  URA. 

See  Appendix  I for  complete  descriptions  about  each 
command  available  on  URA. 

URA  database  Area  where  URL  information  is  stored  (in  a coded  format) 

which  can  then  be  accessed  by  the  commands  allowed  by  URA. 

URA  "object"  Synonymous  with  "name  types".  Any  of  the  objects  that 

can  be  defined  by  URL  (a  SET,  a GROUP,  a PROCESS  are  all 
objects  in  URA).  Usually  referred  to  as  just  "object" 
in  this  paper. 

URL  Acronym  for  "User  Requirement  Language"  which  is  the 

collection  of  all  URL  statements  allowed  for  use  by  URA. 

See  ESD  TR#  ( ) for  complete  descriptions  of 

all  statements  available. 

URL  statements  Those  statements  specified  by  ESD  TR//  ( ) . 

The  statement  presents  one  aspect  of  description  for  a 
particular  URA  "object". 

user  requirement  A set  of  requirements  specified  by  users  of  a proposed 

system  and  interpreted  by  the  user  into  a format  ac- 
ceptable by  the  organization. 
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PART  II 
URA  COMMAND 
DESCRIPTIONS 

i 

i 
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The  objective  of  this  part  is  to  jjive  the  user  of 
the-  User  Requirements  Analyzer  (URA)  a list  of  the 
commands  available  to  him,  the  correct  syntax  of  these 
commands,  and  the  parameters  allowable  for  each  command 
when  usine  URA  in  conjunction  with  the  TCO.  The 
facilities  of  URA  Version  A2.0  are  addressed.  This 
part  assumes  familiarity  with  the  concepts  concerning 


URL /URA  as  presented  in  ESD  TR  75-88,  Vol  I, 
"Introduction  to  Computer  Aided  Requirements  Analysis". 


Purpose:  This  presents  the  function  of  the  command  in  the  URA  system 

whether  it  generates  a report,  modifies  the  data  base  or 
gives  control  information  to  URA.  (Appendix  ii,  "URA  OUTPUTS" 
presents  a detailed  description  of  the  reports  generated 
by  each  command.) 


Prototype:  This  presents  the  legal  syntax  for  the  command.  The  Usage 

Rules  specify  what  the  special  symbols  (such  as  braces  and 
brackets)  represent  in  interpreting  the  syntax. 

Parameters:  For  each  parameter  available  for  the  command,  this  section 

provides  a brief  description  explaining  how  the  parameter 
chanaes  the  action  of  the  command. 


Defaults:  These  present  which  parameters  will  be  used  for  the  command, 

or  what  value  a parameter  will  have,  if  the  parameter,  or 
value,  is  not  explicitly  defined.  For  example,  by  specifying: 

CONTENTS 

The  Defaults  for  this  command  show  that  this  has  the  same 
effect  as  specifying: 

CONTENTS  FILE=URANAMES  NOINDEX  LEVELS=ALL  NONCFLAG 

If  a "no  default"  is  given,  this  means  that  if  not  explicitly 
defined,  the  corresponding  parameter  will  not  be  used  for 
the  cotima  nd. 

Examples:  Actual  example  of  the  command  syntax  are  presented. 
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ABBREVIATIONS 

To  enable  the  user  to  fit  a lengthy  coimiand  on  the  allotted  line  and 
eliminate  some  of  the  tedium  of  command  specification,  abbreviated 
forms  for  both  commands  and  parameters  may  be  used.  Each  abbreviation 
can  be  found  in  parentheses  immediately  following  the  word  it  represents. 
For  example,  the  command: 

CHANGE-TYPE  NAME-GROSS-PAY ■ TYPE-ELEMENT  can  be  written  as 
CT  N=GROSS-PAY  T= ELEMENT 


BLANKS 

A blank  must  appear  between  the  command  and  any  accompanying  parameter, 
and  between  successive  parameters.  Several  blanks  are  treated  as  a 
single  blank  and  may  be  inserted  whenever  a single  blank  is  necessary. 
For  example, 

CT  N=GROSS-PAY  T=ELEMENT  can  be  written  as 
CT  N=GROSS-PAY  T= ELEMENT 


BRACES 

In  the  following  examples,  when  parameters  or  parameter  values  are 
enclosed  in  braces  {{  }),  a choice  among  the  two  or  more  entries  must 

be  made.  It  is  important  to  note  that  one  and  only  one  of  the  options 
must  be  chosen.  For  example,  the  braces  used  in  describing  the  syntax 
of  the  CHANGE-TYPE  command  specifies  that  the  command  must  either  be  of 
the  form: 

CT  N=user-name  T=name-type 

or 

CT  F=dsname  [T=name-type] 


BRACKETS 

Whenever  parameter  notation  in  an  example  appears  within  brackets  C[  ]). 
it  indicates  a feature  the  user  may  optionally  use.  For  example,  the 
brackets  around  the  TYPE  parameter  in  the  CHANGE-TYPE  command  is  optional 
when  the  FILE  parameter  Is  also  used.  Therefore,  the  command  may  be  of 
the  form: 

CT  FILE=dnname  TYPE-name-type 
CT  FILEadrname 
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The  syntax  of  the  FILE  parameter  shows  that  the  parameter  may  be  given 
either  as: 


FILE=df!name  or  just 
FILE 

No  other  variations  are  acceptable  (except  those  already  specified,  i.e., 
abbreviations,  etc.). 


COMMAND  LINE 

Each  command  must  appear  on  a separate  line  and  totally  on  that  line.  A 
command  cannot  be  split  on  succeeding  lines.  Only  columns  1 through  80 
of  each  line  can  be  used. 


COWAN D PARAMETERS 

Parameters  for  a command  are  separated  by  one  or  more  blanks.  Parameters 
may  be  given  in  any  order,  but  are  processed  from  left  to  right.  If 
conflicting  parameters  are  used,  the  right-most  parameter  is  considered 
to  be  correct  and  is  the  one  used  in  the  processing  of  the  command. 


ELLIPSIS 

The  ellips-is  (...)  signifies  that  the  command  construct  inmediately 
preceding  the  ellipsis  can  be  repeated  as  many  times  as  desired  by  the 
user. 

GENERAL  STATEMENT  SYNTAX 

The  conmand  identifiers  (name  of  the  command)  must  precede  any  accompanying 
parameter  or  list  of  parameters. 


INTEGERS 

The  integers  required  for  parameters  must  be  positive  integers.  If  a value 
range  is  given  for  a particular  parameter  description,  that  restriction 
must  also  be  met. 


NAMES 

All  used  defined  names  (user-name)  must  meet  the  following  restrictions 
to  be  a legal  URL  name. 

A name  can  be  formed  only  from  the  following  characters: 

A,  B,  C,  ....  Z (letters) 

0,  1 , 2,  ....  9 (integers) 

- (dash) 

2kO 


S 

u 


PT- 


A name  can  be  any  combination  of  thirty  characters  or  less  where 
the  first  character  is  a letter. 


- Blanks  cannot  be  used  in  the  name. 


A user  defined  name  cannot  be  a URL  RESERVED  WORD.  For  a list 
of  Reserved  words  see  APPENDIX  B of  ESD  TB#  75-88,  vol  II  . 


For  example, 

GROSS-PAY,  EMPLOYEE-NUMBER  and  PAYROLL-PROCESSING 
are  all  legal  names. 

PROCESS,  EMPLOYEE-#  and  123-HILL-STREET 


are  illegal  names.  "PROCESS"  cannot  be  used  as  a user-name  because  it  is 
a URL  Reserved  Word.  "EMPLOYEE-#"  uses  a character  (the  "#"  sign)  which 
is  not  allowed  and  finally,  "123-HILL-STREET"  is  illegal  because  it  starts 
with  an  integer  rather  than  a letter. 
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CHANGE-TYPE 


Purpose : 

Prototype : 
Parameters : 


Examples : 


To  change  the  name  type  of  a user  name  defined  in  the  user's 
data  base.  A record  of  this  change  is  generated  in  the  form 
of  the  CHANGE-TYPE  REPORT. 


CHANGE-TYPE  (CT) 


NAME(N)=user-name  TYPE(T)=na.:ne-type  1 
FILE(F)[=dsname]  [TYPE(T)=name-type]j 


FILE(F) [:dsname]  Default:  no  default 

When  the  FILE  parameter  is  used  and  no  dsname  is  designated, 
the  contents  of  the  file,  -URANAMES,  is  used  as  input  to  the 
connand.  This  file  is  the  default  PUNCH  file  for  NAME-GEN. 

If  a dsname  is  indicated,  that  file  is  used  as  the  input 
file  for  the  comnand.  The  file  format  for  each  line  of  the 
input  file  must  be  of  the  form: 

user-name  [name-type] 

Free  format  is  allowed  so  the  user-name  does  not  have  to  start 
in  the  first  position  in  the  line.  The  two  names  must  be 
separated  by  one  or  more  blanks.  The  name-type  is  optional. 

If  a name-type  is  not  specified  for  each  user-name,  the  name 
type  for  each  of  these  names  will  be  changed  to  the  type 
specified  in  the  TYPE  parameter.  One  of  these  alternative 
methods  of  assigning  a type  must  be  used,  but  not  both.  If 
both  are  used,  all  the  names  in  the  file  will  be  assigned  the 
name  type  specified  by  the  TYPE  parameter. 

NAME(N)=user-name  Default:  no  default 

The  given  user-name  is  the  name  for  which  the  change  is  to 
be  made.  When  the  NAME  parameter  is  used,  the  TYPE  parameter 
must  be  used  in  conjunction  with  it. 


TYPE(T)=name-type  Default:  no  default 

This  parameter  specifies  the  new  name  tvpe  to  be  used  in  the 
change.  See  Appendix  E of  esd  ti#  75-88  , vol'  II  for  a 
list  of  all  possible  name  types. 


CHANGE-TYPE  NAME=GROSS-PAY  TYPE=ELEMENT 
CT  F=T.DATA  T=ELEMENT 
CT  FILE  T=GR0UP 


CONS ISTS-COMPARISON 


Purpose:  To  produce  the  CONSISTS  COMPARISON  REPORT. 

Prototype : CONSISTS-COMPARISON(CNC)  [parameter] . . . 


Parameters: 


Examples: 


i 

i 


i 


FILE(F)[=dsname]  Default:  FILE=  URANAMES 

When  the  FILE  parameter  is  used  and  no  dsname  is  designated, 
the  contents  of  the  file,  URANAMES,  is  used  as  input  to  the 
conmand.  This  file  is  the  default  PUNCH  file  for  NAME -GEN. 

If  a dsname  is  indicated,  that  file  is  used  as  the  input 
file  for  the  command  and  the  report  is  produced  using  all 
the  names  in  the  file.  In  any  case,  the  names  in  the  input 
file  must  be  SET,  INPUT,  OUTPUT,  ENTITY  and/or  GROUP  names. 

The  format  of  the  input  file  must  be  one  name  per  line. 


CNC 

CNC  F=T.DATA 


Purpose:  To  produce  the  CONSISTS  MATRIX  REPORT. 


Prototype:  CONSISTS-MATRIX(CM)  {cONSISTS(CSTS)}}  [parameters]. . . 


Parameter:  FILE(F)[=dsname],  NAME(N)=user-name  Default:  FILE=  URANAMES 

When  the  FILE  parameter  is  used  and  no  dsname  is  designated, 
the  contents  of  the  file,  URANAMES,  is  used  as  input  to  the 
command.  This  file  is  the  default  PUNCH  file  for  NAME-GEN. 

If  a dsname  is  indicated  that  file  is  used  as  the  input  file  « 
for  the  command.  When  a name  is  spAcif1ed  via  the  NAME  parameter, 
the  report  is  produced  only  for  that  name.  The  format  of  the 
input  file  must  be  one  name  per  line. 

CONTAINED(CNTD) , CONSISTS(CSTS)  Default:  no  default 

Since  no  default  exists,  one  of  the  above  must  be  specified. 

If  neither  CONTAINED  nor  CONSISTS  is  specified , an  appropriate 
error  message  will  be  printed.  If  CONTAINED  is  given,  the 
names  used  as  input  must  be  ELEMENT,  GROUP,  ENTITY,  INPUT  and/or 
OUTPUT  names.  If  the  CONSISTS  parameter  is  given  the  names  used 
as  input  must  be  SET,  ENTITY,  INPUT,  OUTPUT  and/or  GROUP  names.. 


Examples:  CM  N=EMPLOYEE-NUMBER  CNTD 

CM  FILE=T.DATA  CSTS 
CM  CSTS 


: 


CONTENTS 

Purpose:  To  produce  the  CONTENTS  REPORT. 


Prototype:  CONTENTS(CONT)  [parameter]... 


Parameters:  FILE(F)[=dsname],  NAME(N)*user-name  Default:  FILE=  URANAMES 

When  the  FILE  parameter  is  used  and  no  dsname  is  designated, 
the  contents  of  the  file,  URANAMES,  is  used  as  input  to  the 
conmand.  This  file  is  the  default  PUNCH  file  for  NAME -GEN. 

If  a dsname  is  indicated,  thatfile  is  used  as  theinput  file 
for  the  comnand  and  the  report  is  produced  for  all  the  names 
in  the  file.  When  a name  is  specified  by  the  NAME  parameter, 
the  report  is  produced  for  that  name  alone.  In  any  case,  the 
names  used  as  input  to  the  command  must  be  SET,  INPUT,  OUTPUT, 
ENTITY  and/or  GROUP  names.  The  format  of  the  input  file  must 
be  one  name  per  line. 

INDEX,  NOINDEX  Default:  NOINDEX 

The  INDEX  parameter  specifies  the  production  of  an  index 
into  the  report  consisting  of  an  alphabetical  listing  of  all 
names  used  in  the  report  and  the  pages  on  which  they  occur. 

LEVELS=  {J[fe96r}  Default:  LEVELS=ALL 

The  LEVELS  parameter  specifies  the  lowest  level  of  subordinate 
names  to  be  outputted.  The  ALL  parameter  indicates  that  all 
subordinate  names  should  be  outputted.  LEVELS  can  take  on  any 
integer  value  from  1 to  50. 

NCFLAG,  NONCFLAG  Default:  NONCFLAG 

The  NCFLAG  parameter  flags  all  GROUPS  in  the  output  reports 
that  do  not  consist  of  anything  else,  and  those  undefined 
names  which  are  contained  in  a GROUP,  INPUT,  OUTPUT,  ENTITY 
or  SET. 


Examples:  CONTENTS  N=VARYING-EMPLOYEE-DATA 

CONT  F-T.DATA 
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DATA-BASE-STATISTICS 


Purpose: 
Prototype : 
Parameters : 


Note: 

Examples: 


To  produce  the  DATA  BASE  STATISTICS  output. 
DATA-BASE-STATISTICS(DBS)  [parameter]. . . 

NAMES,  NONAMES  Default:  NAMES 

For  each  name  in  the  data  base,  NAMES  outputs  the  number 
of  NUBS  with  which  it  is  associated. 

NAMNUBS,  NONAMNUBS  Default:  NONAMNUBS 

NAMNUBS  outputs  a count  of  the  number  of  each  type  of  nub, 

for  each  name  in  the  data  base. 

NUBS,  NONUBS  Default:  NUBS 

Total  number  of  each  type  of  nub  in  the  data  base  is  part 
of  the  output  when  NUBS  is  specified. 

SYNONYMS(SYN),  NOSYNONYMS (NSYN)  Default:  NOSYNONYMS 

SYNONYMS  specifies  that  synonyms  should  be  included  in  the 
list  of  names  in  the  output  report.  Synonyms  do  not,  however, 
have  nubs  associated  to  them. 


This  report  and  the  explanation  of  its  parameters  is  of  no 
direct  relevance  to  the  average  user  of  URA.  The  terminology 
used  here  and  the  value  of  the  output  is  directed  towards  those 
users  who  have  an  active  part  in  maintaining  the  URA  system. 


DATA-BASE-STATISTICS 


DBS 


NONUBS 


DATA-PROCESS 

Purpose:  To  produce  the  DATA  PROCESS  REPORT. 

Prototype:  DATA-PROCESS (DP)  {prJceSS(P)}  [parameter] . . . 


Parameters:  FILE(F)[=dsname],  NAME(N)=user-name  Default:  FILE=  URANAMES 

When  the  FILE  parameter  is  used  and  no  dsname  is  designated, 
the  contents  of  the  file,  URANAMES,  is  used  as  input  to  the 
conmand.  This  is  the  default  PUNCH  file  for  NAME-GEN.  If 
a dsname  is  indicated,  that  file  is  used  as  the  input  file 
for  the  conmand.  The  format  of  the  input  file  must  be  one 
name  per  line. 

When  a name  is  given  via  the  NAME  parameter,  the  report  is 
produced  only  for  that  name. 

DATA(D),  PROCESS(P)  Default:  no  default 

Since  no  default  exists,  one  af  the  above  must  be  specified. 

If  neither  DATA  nor  PROCESS  is  specified,  an  appropriate 
error  message  will  be  printed.  If  DATA  is  specified,  the  names 
used  as  input  to  the  command  must  be  SET,  INPUT,  OUTPUT,  ENTITY, 
GROUP  and/or  ELEMENT  names.  If  PROCESS  is  specified,  the 
names  used  as  input  to  the  command  must  be  PROCESS  names. 


Examples:  DP  N=PAYROLL-PROCESSING  PROCESS 

DP  F=T.DATA  DATA 
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DELETE 

Purpose:  To  delete  a name  or  list  of  names  from  the  data  base.  When 

a name  is  deleted  all  of  its  connections  to  other  names  in 
the  data  base  are  also  deleted.  A permanent  record  of  the 
change  is  also  generated  in  the  form  of  the  DELETION  REPORT. 

Prototype:  DELETE(DEL) 

Parameters:  FILE(F)[sdsname] , NAME(N)=user-name  Default:  no  default 

When  the  FILE  parameter  is  used  and  no  name  is  designated, 
the  contents  of  the  file,  URANAMES,  is  used  as  input  to  the 
comnand.  This  file  is  the  default  PUNCH  file  for  NAME-GEN. 

If  a dsname  is  Indicated,  that  file  is  used  as  the  input  file 
for  the  conmand  and  all  names  in  the  file  are  deleted  from  the 
data  base.  The  format  of  the  input  must  be  one  name  per  line. 
When  a name  is  specified  by  the  NAME  parameter,  that  name  is 
deleted  from  the  data  base.  A warning  will  be  printed  if 
neither  of  these  parameters  is  specified. 


Examples: 


DELETE  N=FIELD-CHECK-NEW 
DEL  FILE=T.DATA 


h. 

f| 

\ 


DELETE-COMMENT-ENTRY 


Purpose: 

Prototype: 
Parameters : 


Examples: 


To  delete  from  the  data  base,  for  the  given  name  or  list 
of  names,  those  conment  entries  associated  with  each  conment 
entry  statement  specified  in  the  list  of  parameters.  A 
permanent  record  of  the  change  is  also  generated  in  the  form 
of  the  DELETED  COMMENT  ENTRIES  report. 

DELETE-COMMENT-ENTRY(DCOM)  &»™eter]... 


When  given  as  parameters,  the  comment  entries  for  the  following 
comment  entry  statement  are  deleted. 

DERIVATION (DER) 

DESCRI PT I ON ( DE  SC ) 

FALSE-WHILE(FW) 

PROCEDURE (PRCD) 

TRUE-WHILE(TW) 

VOLATILITY (VOL) 

VOLATILITY-MEMBER(VOLM) 

VOLATILITY-SET(VOLS) 

Other  parameters 

FILE(F)[=dsname],  NAME(N)=user-name  Default:  no  default 

When  the  FILE  parameter  is  used  and  no  ds name  is  designated, 
the  contents  of  the  file,  uRANAMES,  is  used  as  input  to  the 
command.  This  file  is  the  default  PUNCH  file  for  NAME-GEN. 

If  a dsname  is  indicated,  that  file  is  used  as  the  input  file 
for  the  command.  When  a name  is  given  via  the  NAME  parameter, 
only  the  specified  comment  entries  for  that  name  are  deleted. 
Either  FILE  or  NAME  must  be  given  but  not  both.  The  format 
of  the  input  file  must  be  one  name  per  line. 

PRINT,  NOPRINT(NP)  Default:  PRINT 

The  PRINT  parameter  initiates  the  production  of  a printed 
DELETED  COMMENT  ENTRIES  report.  NOPRINT  suppresses  the 
printing. 


DELETE-COMMENT-ENTRY  N=NEW-INFO-VALIDATION  PRCD  DESC 
DCOM  FILE-T.DATA  DESC 


Default:  no  comment 

entries  are 
deleted 
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DELETE- URL 


Purpose:  To  delete  specific  URL  statements  in  the  user's 

data  base.  Those  statements  used  as  input  to  the  command 
are  deleted.  A permanent  record  for  the  change  Is  generated 
in  the  form  of  the  DELETED  URL  output. 


Prototype:  DELETE- URL ( DURL ) [parameter]  ... 


Parameters:  INPUT[=dsname]  Default:  INPUT=*SOURCE* 

When  INPUT  is  used  and  an  fdname  is  specified,  the  contents 
of  the  designated  dsname  are  used  as  input  to  the  command. 

This  input  must  be  in  the  same  format  allowable  by  the 
INPUT-URL  command  (i.e.,  legal  URL  statements).  The  only 
exception  is  that  no  comment  entry  statements  are  allowed  in 
the  input  (DESCRIPTION,  for  example).  The  EOF  statement 
terminates  input.  If  no  dsname  is  specified,  its  value  defaults 
to  *S0URCE*  so  that  the  URL  statements  can  be  entered  inter- 
actively. 

SOURCE (S) , NOSOURCE(NS)  Default:  SOURCE 

When  the  SOURCE  parameter  is  in  effect,  an  as-is  source  listing 
(the  DELETED  URL  output)  of  the  deleted  URL  statements  is 
produced.  When  the  NOSOURCE  parameter  is  given,  no  source 
listing  is  produced. 

XREF(X) , NOXREF(NX)  • Default:  NOXREF 

The  user  may  desire  a cross  reference  for  the  as-is  source 
listing.  This  consists  of  a list  of  all  user-defined  names 
from  the  input  file  and  the  line  numbers  on  which  they  occur 
in  the  DELETED  URL  outputs.  To  accomplish  this,  the  user 
should  specify  XREF.  When  NOXREF  is  in  effect,  no  cross 
reference  is  produced. 


Example:  DELETE-URL  INPUT=T.DATA 

DURL 


t 
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DICTIONARY 

Purpose:  To  produce  the  DICTIONARY  REPORT  for  a name  or  list  of  names 

In  the  user's  data  base. 


Prototype:  DI CT IONARY (DICT)  [parameter]... 


Parameters:  FILE(F)[=dsname],  NAME(N)=user-name  Default:  FILE=  URANAMES 

When  the  FILE  parameter  is  used  and  nodsname  is  designated, 
the  contents  of  the  file,  URANAMES,  is  used  as  input  to  the 
command.  This  file  is  the  default  PUNCH  file  for  NAME -GEN. 

If  a dsname  is  indicated,  that  file  is  used  as  the  input  file 
for  the  production  cf  the  DICTIONARY  REPORT.  When  a name  is 
specified  via  the  NAME  parameter,  the  report  is  generated  for 
that  name  alone.  The  format  of  the  input  file  must  be  one 
name  per  line. 

INDEX,  NOINDEX  Default:  NOINDEX 


When  given,  the  INDEX  parameter  specifies  the  production 
of  an  index  to  the  report.  This  index  consists  of  an 
alphabetical  listing  of  all  names  used  in  the  report  and 
the  page(s)  on  which  they  occur  in  the  report. 

NUM-SPACE(NS)=integer  Default:  NUM-SPACE=2 

For  ease  in  reading,  the  number  of  lines  skipped  between 
dictionary  entries  can  be  modified  by  varying  this  parameter. 
NUM'-SPACE  may  take  on  any  value  between  0 and  10. 

The  following  parameters  specify  the  information  to  be  included 
in  the  DICTIONARY.  The  "NO"  prefix  on  a parameter  specifies 
that  such  information  not  be  included  for  the  name(s). 

DESCRIPT ION (DESC) , NODESCRIPTION(NDESC)  Default:  DESCRIPTION 

KEYWORDS (KEY),  NOKEYWORDS (NKEY)  Default:  KEYWORDS 

RESPONSIBLE-PD(RPD), 

NORESPONSIBLE-PD(NRPD)  Default:  RESPONSIBLE-PD 

SYNONYMS (SYN) , NOSYNONYMS(NSYN)  Default:  SYNONYMS 

4 

DICTIONARY  N=PAYROLL-PROCESSING 
DICT  FILE=T.DATA 
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ENTITY-IDENTIFIER 

Purpose:  To  produce  the  IDENTIFIER  INFORMATION  REPORT 

Prototype:  ENTITY- IDENTIFIER(EI)  {enTITYCE )RC 1 }}  [parameter]... 


Parameters:  FILE(F)[=dsname] , NAME(N)=user-name  Default:  FILE-  URANAMES 

When  the  FILE  parameter  is  used  and  no  dsname  is  designated, 
the  contents  of  the  file,  URANAMES,  is  used  as  input  to  the 
command.  This  file  is  the  default  PUNCH  file  for  NAME-GEN. 

If  a dsname  is  indicated,  that  file  is  used  as  in  the  input 
file  for  the  command.  If  a name  is  specified  via  the  NAME 
parameter,  the  report  is  generated  for  that  name  alone.  The 
format  of  the  Input  file  must  be  one  name  per  line. 

I DENT IFIER(I) , ENTITY(E)  Default:  no  default 

Since  no  default  is  allowed,  one  of  the  above  must  be  specified. 
If  neither  IDENTIFIER  nor  ENTITY  is  specified,  an  appropriate 
error  message  will  be  printed.  If  IDENTIFIER  is  specified, 
the  names  used  as  input  to  the  command  must  be  names  used  as 
IDENTIFIERS  in  the  data  base.  If  the  ENTITY  parameter  is  given, 
the  names  used  as  input  must  be  defined  ENTITY  names. 


Examples:  El  N=EMPLOYEE-NUMBER  I 

El  FILE=T.DATA  ENTITY 
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FORMATTED-PROBLEM-STATEMENT 


Purpose:  To  produce  the  FORMATTED  PROBLEM  STATEMENT  for  a given  name, 

or  list  of  names  and/or  to  produce  this  information  in  the 
form  of  PUNCH  data. 


Prototype:  FORMATTED-PROBLEM-STATEMENT (FPS ) [parameter]... 


Parameters:  AMARG(AM)=integer  Default:  AMARG=10 

The  AMARG  parameter  indicates  the  column  at  which  the  first 
name  of  a name  pair  is  to  be  outputted.  An  example  of  a 
name  pair  can  be  found  in  the  ATTRIBUTE  statement  where  the 
syntax  requires  an  ATTRIBUTE  name  and  ATTRIBUTE-VALUE. 

BMARG(BM)  integer  Default:  BMARG=25 

The  BMARG  parameter  indicates  the  column  at  which  the  second 
name  of  a name  pair  is  to  be  outputted. 

COMMENT(COM) , NOCOMMENT (NCOM)  Default:  COMMENT 

The  COMMENT  option,  when  in  effect,  specifies  the  inclusion 
of  comments  for  undefined  names.  The  NOCOMMENT  option 
suppresses  these  comments. 

CMARG(CM)=integer  Default:  CMARG=1 

The  CMARG  parameter  specifies  the  number  of  columns  from 
SMARG  the  text  (comment  entry)  for  a comment  entry  statement 
begins. 

DEFINE(DEF) , NODEFINE(NDEF)  Default:  DEFINE 

With  the  DEFINE  option  in  effect,  DEFINE  section  are  included 
in  the  report.  The  NODEFINE  option  specifies  that  no  DEFINE 
sections  are  included  in  the  FORMATTED  PROBLEM  STATEMENT. 

DESG(DG),  NODESG(NDG)  Default:  DESG 

The  DESG  option,  when  in  effect,  indicates  that  DESIGNATE 
sections  are  provided  for  SYNONYM  names  in  the  FORMATTED 
PROBLEM  STATEMENT.  The  NODESG  option  suppresses  the  production 
of  such  output. 


FORMATTED- PROBLEM-STATEMENT  (cont * d) 


EMPTY,  NOEMPTY  Default:  (see  text) 

When  EMPTY  is  in  effect  (the  default  when  the  PUNCH  parameter 
Is  also  used)  the  PUNCH  file  is  emptied  before  PUNCH  data  is 
written  into  It.  When  NOEMPTY  Is  in  effect  (the  default  when 
PUNCH  is  not  used)  no  action  Is  taken  to  empty  the  PUNCH  file. 

FILE(F)[=dsname] , NAME(N)=user-name  Default:  FILE*  'JRANAMES 

When  the  FILE  parameter  is  used  and  no  dsname  is  designated, 
the  contents  of  the  file,  URANAMES,  is  used  as  input  to  the 
comnand.  This  file  is  the  default  PUNCH  file  for  NAME-GEN. 

If  a dsname  is  indicated,  that  file  is  used. as  the  input  file 
for  the  command.  When  a name  is  given  via  the  NAME  parameter, 
the  report  is  produced  only  for  the  name  specified.  The  format 
of  the  input  file  must  be  one  name  per  line. 

HMARG|  r:M'=integer  Default:  HMARG=40 

This  parameter  specifies  the  column  where  the  user  defined 
name  in  a section  header  statement  are  to  be  printed  on  the 
output. 

INDEX,  NOINDEX  Default:  NOINDEX 

The  INDEX  parameter  specifies  the  production  of  an  index 
for  the  FPS.  This  index  consists  of  an  alphabetical  listing 
of  all  user  defined  names  used  in  the  FORMATTED  PROBLEM 
STATEMENT  and  the  page(s)  on  which  they  occur. 

NEW-LINES(NL) , NONEW-LINE(NNL)  Default:  NONEW-LINE 

When  the  NEW-LINE  parameter  is  given,  the  first  name  of 
a name  list  associated  with  a statement  will  appear  on  the 
line  succeeding  the  statement  identifier  (name  of  the  statement). 
The  NONEW-LINE  parameter  initiates  the  list  on  the  same  line 
as  the  statement  identifier  (name  of  the  statement).  The 
NONEW-LINE  parameter  initiates  the  list  on  the  same  line  as 
the  statement  identifier. 

NEW-PAGE(NPG) , NONEW-PAGE(NNPG)  Default:  NONEW-PAGE 

When  given,  the  NEW-PAGE  parameter  specifies  that  each 
section  of  the  FPS  be  printed  on  a separate  page.  NONEW-PAGE 
signifies  that  the  sections  will  follow  one  another  on  a 
page  within  the  page  size  restrictions.  In  any  case,  interrupted 
sections  will  be  continued  on  succeeding  pages. 
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FORMATTED-PROBLEM-STATEMENT  (cont'd) 


NMARG(NM)=integer  Default:  NMARG=20 

The  NMARG  parameter  indicates  the  column  in  which  the  name  or 
first  name  of  a name  list  for  any  statement  will  be  outputted. 

ONE-PER-LINE(OPL) , SEVERAL-PER-LINE(SPL)  default:  ONE-PER-LINE 

The  ONE-PER-LINE  option  indicates  that  the  names  in  a name 
list  for  any  statement  will  appear  on  succeeding  lines. 
SEVERAL-PER-LINE  option  signifies  that  names  in  a name  list 
will  appear  on  the  same  line. 

PRINT,  NOPRINT(NP)  Default:  PRINT 

The  NOPRINT  parameter  specifies  that  no  printed  output  report 
will  be  produced.  The  PRINT  parameter  specifies  the  production 
Of  the  FORMATTED  PROBLEM  STATEMENT. 

PUNCH(P) [-d&name] , NOPUNCH  Default:  NOPUNCH 

The  PUNCH  parameter  specifies  that  PUNCH  data  should  be 
generated  and  written  into  the  designated  PUNCH  file.  When 
the  PUNCH  parameter  is  used  and  no  dsname  is  designated,  the 
data  is  written  into  the  file,  URAFORMLIST.  This  file  is  the 
default  PUNCH  file  for  the  command.  If  a dsname  is  indicated, 
that  file  is  used  as  the  PUNCH  file.  With  the  NOPUNCH  parameter 
In  effect,  no  action  is  taken  to  generate  PUNCH  data. 

RNMARG(RM)  integer  Default:  RNMARG=70 

Specifies  the  right-hand  margin  for  names  in  a name  list 
when  the  SEVERAL-PER-LINE  parameter  is  in  effect. 

SMARG(SM)  integer  Oefault:  SMARG=5 

The  SMARG  parameter  indicates  the  column  in  which  the  statement 
Identifier  (name  of  the  statement)  will  be  started. 


Examples:  FPS  N=FIELD-CHECK-NEW 

FPS  FILE=T.DATA 


255 


r 


FREQUENCY 

Purpose: 

To  produce  the  FREQUENCY  REPORT. 

Prototype: 

FREQUENCY (FREQ) 

Parameters : 

None 

Examples: 

FREQ 

' 
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HELP 

Purpose: 

Prototype; 

Parameters: 


Examples: 


To  provide  the  on-line  user  with  a list  of  possible  commands 
for  URA  or  informatlor  about  the  parameters  for  a particular 
URA  command. 


HELP  [parameter]... 


Command-name  Default:  (see  text) 

If  no  command-name  is  given,  a list  of  currently  available 
URA  commands  is  given.  If  a conmand-name  is  given,  then 
the  parameters  for  that  command  are  presented.  Abbreviations 
for  the  command-name  are  also  acceptable  assuming  they  are 
known  by  the  user. 

SHORT,  LONG  Default:  SHORT 

If  SHORT  is  given,  only  the  parameters  for  the  given  command 
are  printed.  If  LONG  is  given,  explanations  of  the  various 
parameters  are  also  printed. 


HELP  FPS  LONG 
HELP  CONTENTS 
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INPUT-URL 


Purpose: 

Prototype: 

Parameters 


Examples: 


To  add  information  to  the  URA  data  base  to  expand  or  modify 
the  user  requirements.  A permanert  record  of  the  change  is 
also  generated  in  the  form  of  the  AS-IS  SOURCE  LISTING  and 
CROSS  REFERENCE. 


INPUT- URL( IP)  [parameter]... 


: DBREF(D),  NODBREF(ND)  Default:  DBREF 

The  DBREF  parameter  allows  the  referencing  of  the  data  base 
by  URA  in  its  syntax  and  semantic  analysis.  When  given,  NODBREF 
allows  the  analyzer  to  only  perform  a syntax  check  of  the  input. 

INPUT(I)=dsname  Default:  INPUT=*$OURCE* 

When  INPUT  Is  specified,  the  contents  of  the  designated  dsname 
are  used  as  input  to  the  command.  This  input  must  be  in  the 
format  of  legal  URL  statements  as  specified  byESD  tr#  75-88,  vol 
'URL  USERS  MANUALt'The  EOF  statement  terminates  input.  If  the 
INPUT  parameter  is  not  specified,  input  is  read  from  *S0URCE* 
so  that  the  URL  statements  can  be  entered  interactively. 

SOURCE (S) , NOSOURCE (NS)  Default:  SOURCE 

When  the  SOURCE  parameter  is  in  effect,  AS-IS  SOURCE  LISTING 
of  the  input  URL  is  produced.  When  the  NOSOURCE  parameter  is 
given,  the  listing  is  not  produced. 

UPDATE (U) , NOUPDATE (NU)  Default:  NOUPDATE 

With  the  UPDATE  parameter  given,  the  input  will  update  the 
URA  data  base.  NOUPDATE  indicates  that  the  data  base  is  not 
to  be  changed. 

XREF(X),  NOXREF(NX)  Default:  NOXREF 

XREF  specifies  that  a URA  CROSS  REFERENCE  is  to  be  generated 
for  the  AS-IS  SOURCE  LISTING.  This  consists  of  a list  of 
all  user  defined  names  from  the  input  file  and  the  line  numbers 
on  which  they  occur. 


INPUT-URL  I=IFILE  XREF  UPDATE 
IP  U 
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KWIC 


To  produce  a KWIC  INDEX  for  a list  of  names. 


Prototype:  KWIC  [parameter]... 


Parameters:  FILE(F)[*dsname] 


Default:  FILE=  URANAMES 


When  the  FILE  parameter  is  used  and  no  dsname  is  designated, 
the  contents  of  the  file,  URANAMES,  is  used  as  input  to  the 
command.  This  file  is  the  default  PUNCH  file  for  NAME-GEN. 

If  a dsname  is  indicated,  that  file  is  used  as  the  input  file 
for  the  command.  The  format  of  the  input  file  must  be  one 
name  per  line. 


DIF=1nteger 


Default:  DIF=20 


DIF  is  the  number  of  spaces  allowed  between  the  keyword  and 
the  rest  of  the  name  as  it  appears  in  the  output.  In  order 
to  fit  the  output  on  an  8-1/2  x 11  inch  page,  the  following 
restriction  is  necessary: 

2 < DIF  < 52 


Examples:  KWIC  F=T.DATA 
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NAME-GEN 


Purpose:  To  produce  the  NAME-GEN  report  and/or  retrieve  certain  names 

to  be  put  in  a PUNCH  file  and  used  as  input  to  other  commands. 


Prototype:  NAME-GEN(NG)  [parameter]... 


Parameters : 


The  following  retrieval  parameters  indicate  the  types  of  names 
to  be  retrieved  and  placed  in  the  output  file.  A "NO"  prefix 
attached  to  a parameter  means  that  names  of  that  type  are 
not  to  be  retrieved. 


Name  Type 

Default: 

ATTRIBUTE (ATTR),  NOATTRIBUTE (NATTR) 

NOATTRIBUTE 

ATTRIBUTE-VALUE(ATTV) , NOATTRIBUTE-VALUE (NATTV) 

NOATTRIBUTE-VALUE 

CONDITION(COND,  NOCONDITION(NCOND) 

NOCONDITION 

ELEMENT(ELE) , NCELEMENT(NELE) 

NOELEMENT 

ENTITY(ENT) , NOENTITY (NENT) 

NOENTITY 

EVENT (EV) , NOEVENT(NEV) 

NOEVENT 

GROUP (GR) , NOGROUP(NGR) 

NOGROUP 

INPUT ( INP ) , NOINPUT(NINP) 

NOINPUT 

INTERVAL(INT) , NOINTERVAL(NINT) 

NOINTERVAL 

KEYWORD(KEY) , NOKEYWORD(NKEY) 

NOKEYWORD 

MAILBOX(BOX) , NOMAILBOX(NBOX) 

NOMAILBOX 

MEMO,  NOMEMO(NMEMO) 

NOMEMO 

OUTPUT (OUT) , NOOUTPUT (N OUT) 

NOOUTPUT 

PROBLEM-DE FI NE R( PD) , NOPROBLEM-OEFINER(NPD) 

NOPROBLEM-DEFINER 

PROCESS(PROC) , NOPROCESS (NPROC) 

NOPROCESS 

REAL-WORLD-ENTITY(RWE) , NOREAL-WORLD-ENTITY(NRWE) 

NOREAL-WORLD-ENTITY 

RELATION (RLN),  NORELATION(NRLN) 

NORELATION 

SECURITY (SEC),  NOSECURITY (NSEC) 

NOSECURITY 

SET,  NOSET 

NOSET 

SOURCE (SRC) , NOSOURCE(NSRC) 
SUBSETTING-CRITERION(SSCN) , 

NOSOURCE 

NOSUBSETTING-CRITERION(NSSCN) 

NOSUBSETTING-CRITER] 

SYNONYMS (SYN),  NOSYNONYMS (NSYN) 

NOSYNONYMS 

SYSTEM-PARAMETER(SYSP) , NOSYSTEM-PARAMETER(NSYSP) 

NOSYSTEM-PARAMETER 

UNDEFINED(UNDF) , NOUNDEFINED(NUNDF) 

NOUN DEFINED 
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NAME-GEN  (cont'd) 


NONE,  ALL  Default:  None 

With  the  NONE  parameter,  all  Name  Type  switches  are  set  to 
an  "off"  position  and  names  of  no  types  (hence,  no  names)  are 
retrieved.  When  the  ALL  parameter  is  given,  all  types  of  names 
are  Included  In  the  output  except  SYNONYMS  and  UNDEFINED  names. 

TOTAL  Default:  no  default 

The  TOTAL  parameter  specifies  the  inclusion  of  all  name  types 
Including  SYNONYMS  and  UNDEFINED  names  in  the  output. 


SUBLEVEL(SL)=1nteger  Default:  SUBLEVELS 

This  parameter  (to  be  used  in  conjunction  with  the  SUBPARTS-OF 
parameter)  specifies  the  level  to  which  the  SUBPARTS  tree  should 
be  traversed  and  names  retrieved.  The  zero  (0)  value  indicates 
all  levels  should  be  retrieved. 


SUBPARTS-OF(SO) “user-name  Default:  no  default 

This  parameter  retrieves  all  SUBPARTS  (down  to  the  level 
specified  by  the  SUBLEVEL  parameter)  of  the  designated  user- 
name.  The  user-name  may  be  a PROCESS,  INPUT,  OUTPUT  or  REAL- 
WORLD-ENTITY  name. 


IDENTIFIER(ID) , 

IDENTI FIER-ELEMENT(IDE) , IDENTIFIER-GROUP(IDG) 

Default:  no  default 

IDENTIFIER  retrieves  only  those  names  which  are  used  as 
IDENTIFIERS  in  the  data  base.  IDENTIFIER-ELEMENT  retrieves 
only  those  that  are  defined  as  ELEMENT  names  and  are  used  as 
IDENTIFIERS,  and  IDENTIFIER-GROUP  retrieves  only  those  defined 
as  GROUP  names  and  are  used  as  IDENTIFIERS. 


Specific  names  can  be  selected  from  those  names  retrieved  by 
the  retrieval  parameters  when  using  the  following  selection 
parameters: 

BASIC,  NOBASIC  Default:  BASIC 

The  BASIC  parameter  specifies  that  basic  names  be  included 
In  the  output  list  of  the  requested  name  types.  "Basic" 
names  are  those  names  which  are  not  SYNONYMS. 
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NAME-GEN  (cont'd) 


KEY = user- name  Default:  no  default 

Only  those  names  with  the  given  user-name  as  a KEYWORD 
are  selected  to  be  part  of  the  output.  The  user-name  must 
be  a name  defined  as  a KEYWORD  in  the  data  base. 

PD*user-name  Default:  no  default 

Only  those  names  associated  with  the  specified  PROBLEM-DEFINER 

are  selected  to  be  part  of  the  output.  The  user-name  must  be 
a PROBLEM-DEFINER  name  defined  in  the  data  base. 

Other  parameters: 

0RDER=  {bytype}  Default:  ORDER=ALPHA 

With  ORDER  equal  to  ALPHA,  the  report  presents  the  retrieved 
names  in  alphabetical  order  by  name.  BYTYPE  signifies  that 
the  names  are  grouped  by  name  type  with  the  types  alphabetically 
ordered  and  names  within  the  same  type  ordered  alphabetically 
by  name. 

PRINT,  NOPRINT(NP)  Default:  PRINT 

The  PRINT  parameter  initiates  the  production  of  a printed 
output  (NAME  GEN);  NOPRINT  suppresses  printing  of  such  a 
report . 

EMPTY,  NOEMPTY  Default:  (see  text) 

When  EMPTY  is  in  effect  (the  default  when  the  PUNCH  parameter 

is  also  used)  the  PUNCH  file  is  emptied  before  the  list  of 
names  is  written  into  it.  When  NOEMPTY  is  in  effect  (the 
default  when  PUNCH  is  not  used)  no  action  is  taken  to  empty 
the  PUNCH  file. 

PUNCH(P) [=dsname] , NGPUNCH  Default:  PUNCH=URANAMES 

The  PUNCH  parameter  specifies  that  PUNCH  data  should  be 
generated  and  written  into  the  designated  PUNCH  file.  When 
the  PUNCH  parameter  is  used  and  r.odsname  is  designated,  the 
data  is  written  into  the  file,  IJRANAMES.  This  file  is  used 
as  the  PUNCH  file.  With  the  NOPUNCH  parameter  in  effect,  no 
action  is  taken  to  generate  PUNCH  data. 


Exampl es : 

NG 

PROCESS  RUE 

NG 

ALL 

NG 

ALL  KEY=L1 

NG 

SO=TIME-CARD  PD=WALTER-J-RATAJ  KEY=L1 
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NAME-LIST 
Purpose : 

Prototype : 
Parameters : 

Examples: 


To  produce  an  alphabetical  list  of  all  the  names  in 
the  data  base  with  their  respective  name  types  and 
any  synonyms  associated  with  the  name. 


NAME-LIST(NL)  [parameter].... 

ORDER-j^j 

If  ORDER-ALPHA  is  specified,  the  list  is  ordered  by 
the  URA  name  of  the  object,  if  ORDER=BYTYPE  is  specified, 
the  order  is  alphabetical  by  name  type,  with  objects  of 
the  same  type  being  ordered  by  name. 


NAME-LIST 
NL  ORDER=BYTYPE 
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PICTURE 

Purpose:  To  produce  the  PICTURE  report. 

Prototype:  PICTURE(PIC)  [parameter]... 


Parameters:  DATA(O),  NODATA(ND)  Default:  DATA 

With  the  DATA  parameter  in  effect,  information  applicable 
and  available  for  the  given  name,  or  list  of  names  other 
than  structure  or  flow  data  is  printed  on  the  output. 

NODATA  inhibits  such  action. 

FILE(F)[=dspame],  NAME(N)=user-name  Default:  FILE=  URANAMES 

When  the  FILE  parameter  is  used  and  no  dsname  is  designated, 
the  contents  of  the  file,  URANAMES,  is  used  as  input  to  the 
command.  This  file  is  the  default  PUNCH  file  for  NAME-GEN. 

If  a dsname  is  indicated,  that  file  is  used  as  the  input 
file  for  the  command.  When  a name  is  given  via  the  NAME 
parameter,  the  report  is  produced  only  for  that  name.  In 
any  case,  the  names  used  as  input  to  this  command  must  be 
PROCESS,  RWE,  SET,  ENTITY,  INPUT,  OUTPUT,  ENTITY,  GROUP  and/or 
ELEMENT  names.  The  format  of  the  input  file  must  be  one  name 
per  line. 

FLOW, 'NOFLOW  Default:  FLOW 

This  parameter  presents  flow  information  in  the  PICTURE  report. 
It  presents  RECEIVES  and  GENERATES  information  between  INPUTS 
and  OUTPUTS  with  PROCESSES  and  RWEs.  It  also  presents  USES 
and  DERIVES  information  between  PROCESSES  and  data  (such  as 
SETS,  ENTITIES,  GROUPS  and  ELEMENTS). 


INDEX,  NOINDEX  Default:  NOINDEX 

The  INDEX  parameter  specifies  the  production  of  an  index 
for  the  PICTURE  report.  This  index  consists  of  all  user 
defined  names  used  in  the  report,  in  the  report,  in  alphabetical 
order  and  the  pages  on  which  they  appear  in  the  report. 

STRUCTURE(STR) , NOSTRUCTURE(NSTR)  Default:  STRUCTURE 

When  the  STRUCTURE  parameter  is  in  effect,  the  information 
available  in  the  SUBPARTS,  CONSISTS  and/or  SUBSETS  statements 
and  their  complementary  statements  for  the  input  name(s) 
appears  in  the  report. 


Examples:  PICTURE  N=PAY CALC-UPDATING 

PIC  N=PAY ROLL-PROCESSING  NODATA  NOFLOW 
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PRINT-ATTRIBUTE-VALUES 

Purpose:  To  produce  the  ATTRIBUTE  REPORT. 


Prototype:  PRINT-ATTRIBUTE-VALUES(PAV)  [parameter]... 


Parameters:  FILE(F)[=dsname],  NAME(N)=user-name  Default:  FILE=  URANAMES 

When  the  FILE  parameter  is  used  and  no  dsname  is  designated, 
the  contents  of  the  file,  URANAMES,  is  used  as  input  to  the 
command.  This  file  is  the  default  PUNCH  file  for  NAME-GEN. 

If  andsname  is  indicated,  that  file  is  used  as  the  input  file 
for  the  command.  The  input  file  format  must  be  one  ATTRIBUTE 
name  per  line.  When  a name  is  specified  by  the  NAME  parameter, 
the  report  is  generated  for  that  name  only.  In  any  case,  only 
ATTRIBUTE  names  may  be  used  as  input  to  this  command. 


Examples:  PRINT-ATTRIBUTE-VALUES  FILE -T. DATA 

PAV  N*TYPE 
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PROCESS-INPUT-OUTPUT 


Purpose: 

Prototype: 

Parameters: 


To  produce  the  PROCESS  INPUT/OUTPUT  report  and/or  to  retrieve 
data  names  in  the  form  of  PUNCH  data  to  be  used  as  input  to 
other  commands. 


PROCESS-INPUT-OUTPUT(PRIO)  [parameter]... 


FILE(F)=[dsname],  NAME(N)=user-name  Default:  FILE=  URANAMES 

When  the  FILE  parameter  is  used  and  no  ds name  is  designated, 
the  contents  of  the  file,  URANAMES,  is  used  as  input  to  the 
command.  This  file  is  the  default  PUNCH  file  for  NAME-GEN. 

If  ar  dsname  is  indicated,  that  file  is  used  as  the  input  file 
for  the  command  and  the  report  is  produced  using  all  the  names 
in  the  file.  When  a single  name  is  specified  by  the  NAME 
parameter,  the  report  is  produced  for  that  name  alone.  Either 
FILE  or  NAME  can  be  used  to  implement  the  command  but  not  both. 
In  any  case,  all  the  names  used  as  input  to  this  command  must 
be  PROCESS  names.  The  input  file  format  is  one  PROCESS  name 
per  line. 

DESCRIPTION(DESC) , NODESCRIPTION(NDESC) 

Default:  DESCRIPTION 

When  the  DESCRIPTION  parameter  is  in  effect,  the  comment-entry 
associated  with  the  DESCRIPTION  statement,  for  each  PROCESS 
names  used  as  input,  is  retrieved  and  printed  on  the  report. 
NODESCRIPTION  specifies  that  this  information  is  not  to  be 
retrieved. 

PROCEDURE(PRCD) , NOPROCEDURE (NPRCD)  Default:  NOPROCEDURE 

When  the  PROCEDURE  parameter  is  specifed,  the  comment  entry 
associated  with  the  PROCEDURE  statement,  for  each  PROCESS 
name  used  as  input,  is  retrieved  and  printed  on  the  report. 
With  the  NOPROCEDURE  parameter  in  effect,  this  information  is 
not  retrieved. 

INPUT ( INP ) , NOINPUT(NINP)  Default:  INPUT 

When  the  INPUT  parameter  is  in  effect,  all  the  names  of 
objects  used  as  input  to  each  PROCESS  (i.e.,  names  associated 
with  the  RECEIVES  and  USES  statements)  are  retrieved  and 
printed  on  the  report.  The  NOINPUT  parameter  specifies  that 
this  information  is  not  to  be  retrieved. 
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PROCESS-INPUT-OUTPUT  (cont'd) 


OUTPUT(OUT),  NOOUTPUT (NOUT)  Default:  OUTPUT 

When  the  OUTPUT  parameter  is  in  effect,  all  the  names  of 
objects  designated  as  output  from  each  PROCESS  (i.e.,  names 
associated  with  the  GENERATES,  DERIVES,  and  UPDATES  state- 
ments) are  retrieved  and  printed  on  the  report.  The 
NOOUTPUT  parameter  specifies  that  this  information  is  not 
to  be  retrieved. 

PUNCH(P)[=dsname],  NOPUNCH  Default:  NOPUNCH 

When  PUNCH  is  specified,  all  those  names  retrieved  as  input 
or  output  (see  the  INPUT  and  OUTPUT  parameters)  are  put  into 
a PUNCH  file.  When  an  dsname  is  given,  the  list  of  names  is 
written  into  that  fdname.  If  no  dsname  is  specified,  the 
list  of  names  is  written  into  URANAMES  (which  is  also  the 
default  PUNCH  file  for  NAME-GEN).  When  NOPUNCH  is  in  effect, 
the  names  are  not  written  into  a PUNCH  file. 


EMPTY,  NOEMPTY  Default:  (see  text) 

When  EMPTY  is  in  effect  (the  default  when  the  PUNCH  parameter 
is  also  used)  the  PUNCH  file  is  emptied  before  the  list  of 
names  is  written  into  it.  When  NOEMPTY  is  in  effect  (the 
default  when  PUNCH  is  not  used)  no  action  is  taken  to  empty 
the  PUNCH  file. 


INDEX,  NOINDEX 


Default:  NOINDEX 


When  given,  the  INDEX  parameter  specifies  the  production 
of  an  index  into  the  report.  The  index  consists  of  all 
input  and  output  names  in  the  report,  in  alphabetical  order 
and  the  page(s)  on  which  they  occur  in  the  report. 


NEW-PAGE(NPG) , NONEW-PAGE(NNPG)  Default:  NONEW-PAGE 


When  given,  the  NEW-PAGE  parameter  specifies  that  each  section 
of  the  PROCESS  INPUT/OUTPUT  report  be  printed  on  a separate 
page.  NONEW-PAGE  signifies  that  the  sections  will  follow  one 
another  on  a page  within  the  page  size  restrictions.  In  any 
case,  interrupted  sections  will  be  continued  on  succeeding  pages. 


PRINT,  NOPRINT(NP)  Default:  PRINT 

The  NOPRINT  parameter  specifies  that  no  printed  output  report 
will  be  produced.  The  PRINT  parameter  specifies  the  production 
of  the  PROCESS  INPUT/OUTPUT  report. 

Examples:  PRIO  N=PAYROLL-PROCESSING 

— PRIO  f=t.data  NDESC  npg  prcd 

■ 
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PUNCH-COMMENT-ENTRY 

Purpose:  To  produce  the  PUNCHED  COMMENT  ENTRIES  report  and/or  punch 

the  specified  comment  entries  into  a PUNCH  file. 


Prototype:  PUNCH-COMMENT-ENTRY (P COM)  [parameter]... 


Parameters:  The  comment  entries  associated  with  the  following  types  of 

comment  entry  statements  are  retrieved  when  given  as  parameters. 


DERIVATION 
DESCRIPTION(DESC) 
FALSE-WHILE(FW) 
PROCEDURE(PRCD) 
TRUE-WHILE(TW) 
VOLATILITY (VOL) 
VOLATILITY-MEMBER(VOLM) 
VOLATILITY -SET(VOLS) 

Other  parameters: 

EMPTY,  NOEMPTY 


Default: 


no  comment 
entries  are 
retrieved 


Default:  (see  text) 


When  EMPTY  is  in  effect  (the  default  when  the  PUNCH  parameter 
is  also  used)  the  PUNCH  file  is  emptied  before  PUNCH  data  is 
written  into  it.  When  NOEMPTY  is  in  effect  (the  default  when 
PUNCH  i*  not  used)  no  action  is  taken  to  empty  the  PUNCH  file. 

FILE(F)[=dsname],  NAME(N)=user-name  Default:  FI LE=  URANAMES 

When  the  FILE  parameter  is  used  and  no  dsname  is  designated, 
the  contents  of  the  file,  URANAMES,  is  used  as  input  to  the 
command.  This  file  is  the  default  PUNCH  file  for  NAME-GEN. 

If  a dsname  is  indicated,  that  file  is  used  as  the  input  file 
for  the  command.  When  a name  is  specified  by  the  NAME  parameter, 
the  output  is  produced  for  that  name  alone.  The  format  of 
tne  input  file  must  be  one  name  per  line. 


PRINT,  NOPRINT(NP) 


•Default:  PRINT 


The  PRINT  parameter  initiates  the  production  of  printed 
output  for  the  report.  When  the  NOPRINT  parameter  is  given, 
the  PUNCHED  COMMENT  ENTRIES  report  is  not  produced. 
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PUNCH-COMMENT-ENTRY  (cont'd) 

PUNCH  (P)  [--dsname],  NOPUNCH  Default:  PUNCH=  URAPCOM 

The  PUNCH  parameter  specifies  that  PUNCH  data  should  be 
generated  and  written  into  the  designated  PUNCH  file.  When 
the  PUNCH  parameter  is  used  and  no  dsname  is  designated,  the 
data  is  written  into  the  file,  'JRAPCOM.  This  file  is  the 
default  PUNCH  file  for  the  command.  If  a dsname  is  indicated, 
that  file  is  used  as  the  PUNCH  file.  With  the  NOPUNCH  parameter 
in  effect,  no  action  is  taken  to  generate  PUNCH  data. 


Examples:  PCOM  N=PAYROLL-PROCESSING  DESC 

PCOM  f=t.data  DESC  prco 
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RENAME 


Purpose:  To  change  the  name  of  some  object  in  the  data  base  and  to 

produce  the  RENAME  REPORT  as  a permanent  record  of  the  change. 


Prototype:  RENAME (REN) 


0LD(0)=user-name 

INPUT(I)=dsname 


NEW(N)=user-name 


Parameters:  lNPUT(I)sdsna« 


Default:  no  default 


For  multiple  name  changes,  an  input  file  can  be  used.  Each 
line  of  the  file  must  consist  of  the  old  name  followed 
by  the  new  name.  The  two  names  must  be  separated  by  one 
or  more  blanks. 


0LD(0)=user-name 


Default:  no  default 


The  user-name  specified  here  is  the  name  that  is  to-be  changed. 
This  name  must  be  defined  in  the  data  base. 


NEW(N)=user-name 


Default:  no  default 


The  user-name  specified  here  is  the  name  to  replace  the  old 
name.  If  the  new  name  is  already  in  the  data  base,  the  name 
will  not  be  changed. 

For  a single  change,  both  OLD  and  NEW  must  be  given  with  legal 
values. 


Examples:  RENAME  0LD=EMPL0YEE-C0DE  NEW=EMPLOYEE-NUMBER 

REN  INPUT=T.DATA 
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REPLACE-COMMENT-ENTRY 

Purpose:  To  replace,  for  a given  name,  specific  comment  entries 

associated  to  It.  A REPLACED  COMMENT  ENTRIES  report  is 
also  printed  as  a permanent  record  of  the  change. 


Prototype:  REPLACE-COMMENT-ENTRY (RCOM)  [parameter]... 


Parameters:  INPUT(I)=dsname  Default:  INPUT=  URAPCOM 

The  designated  dsname  contains  the  new  comment  entries  that 
will  replace  specified  old  comment  entries  in  the  data  base. 
The  required  format  of  the  file  is  the  same  as  that  punched 
by  PUNCH -COMMENT-ENTRY.  If  INPUT  is  not  given,  the  input  will 
be  taken  from  URAPCOM.  For  each  comment  entry  to  be  replaced, 
the  following  format  must  be  given  in  the  input  file: 

name 

comment-entry  type 


comment  entry  text 


• » 

Where  name  is  a name  defined  in  the  data  base,  the  comment- 
entry-type  (e.g.,  DESCRIPTION,  VOLATILITY,  etc.)  must  be 
followed  by  a semicolon.  The  text  following  this  must  also 
be  followed  by  a semicolon.  This  sequence  of  lines  can  be 
repeated  as  many  times  as  necessary  in  the  input  file. 

PRINT,  NOPRINT(NP)  Default:  PRINT 

The  PRINT  parameter  initiates  the  production  of  the  REPLACED 
COMMENT  ENTRIES  report;  NOPRINT  suppresses  printing.  The 
report.  If  produced,  contains  both  the  old  and  new  comment 
entries. 


Examples:  RCOM  I “PUNCH 
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SET 

Purpose: 

Prototype: 

Parameters: 


Examples: 


To  set  various  global  switches  and  parameters. 

SET  ( parameter) . . . 

DATABASE  (DB)=  database-name  DEFAULT:  DATABASE=URADB 

The  file  named  is  the  file  in  which  the  database  is  assembled 
and  stored.  This  facility  allows  the  user  to  change  databases 
conveniently  and  quickly. 

ON 

ECHO(E)=  OFF  Defaults:  ECHO=ON  in  batch  mode, 

ECHO=OFF  in  conversation;: 
mode 

With  ECHO  set  equal  to  ON,  the  commands  are  printed  on  the 
current  output  device  (i:‘SOURCE'!:')  as  they  are  encountered. 

This  is  more  desirable  in  batch  (command  is  printed  on  line 
printer)  than  in  on-line  mode  (you  always  see  the  command 
y ju  type  in  anyway). 

INPUT ( I ) =ds  name  Default:  INPUT-* SOURCE* 

This  parameter  specifies  the  file  from  which  subsequent  URA 

commands  should  be  read  from. 

LINES(L)=integer  Default:  LINKS=45 

The  number  of  lines  printed  by  URA  per  page  is  set  to  the 
indicated  number.  The  default  number  fits  the  output  to  a 
8-1/2  x 11  inch  page  for  convenient  binding.  LINES  may  take 
on  any  value  between  10  and  500. 

OUTPUT (0)=dsname  Default:  OUTPUT=*SO[JROK* 

This  parameter  specifies  where  all  output  resulting  from 
any  subsequent  URA  commands  should  be  written  into. 

PROMPT (P)=  Qpp  Defaults:  PR0MPT=0N  in  conver- 

sational mode, 

PROMPT =0FF  in  batch 
mode. 

If  PROMPT  is  set  to  ON,  URA  will  prompt  the  user  for  the 
correct  command  or  parameters  when  an  error  is  encountered. 

With  PROMPT  set  to  OFF,  URA  will  ignore  invalid  commands 
and  parameters  and  proceed  to  the  next  command  or  parameter. 

SET  DB  URADB. DATABASE 

SET  OUTPUT-OUTPUT. DATA 


272 


* This  differs  from  the  interrupt  as  the  user  cannot  issue  a 
EXEC  CLI  to  return  control  to  URA. 
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STRUCTURE 


Purpose: 

Prototype: 

Parameters: 


Examples: 


To  produce  a STRUCTURE  report  for  INPUTS,  OUTPUTS,  PROCESSES, 
or  REAL-WORLD-ENTITIES. 

STRUCTURE (STR)  [parameter]... 


INDENT ( IND)= i nteger  Default:  INDENT=3 

The  number  is  the  number  of  spaces  to  indent  each  succeeding 
level  in  the  report.  INDENT  can  take  on  any  value  between  1 
and  10. 


INDEX,  NOINDEX 


Default:  NO INDEX 


The  INDEX  parameter,  when  given,  specifies  the  production 
of  an  index  to  the  report,  giving  the  pages  on  which  each 
undefined  name  used  in  the  report  occurs.  NOINDEX  specifies 
that  no  index  should  be  generated. 


URA  will  produce  structure  reports  for  the  following  name 
types  when  given  as  parameters.  (Only  one  may  be  given  for 
each  report. ) 


"input  (INP) 

OUTPUT (OUT) 

' PROCESS (PROC) 
^REAL-WORLD- ENTITY ( RWE ) 


Default:  PROCESS 


i 


STRUCTURE 
STR  INPUT 


# 


1 
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SUMMARY 


Purpose: 
Prototype : 
Parameters : 
Examples: 


I 


1 


To  produce  the  DATA  BASE  SUMMARY  output. 

SUMMARY (SUM) 

no  parameters 

SUMMARY 

SUM 


: 


APPENDIX  A 


Not es  on  Running  URA  Under  TSO 

To  create  a URA  database,  the  following 
commands  should  be  given: 

EXEC  NEWDB  ' dfcname. database ' 

URADB . D ATABAS E is  URA's  default  name  for  the  URA 
database.  if  the  user  names  his  database 
something  other  an  URADB. DATABASE,  the  name  must 
be  specified  via  the  SET  command  before  running 
any  URA  commands. 

For  example,  if  the  user  database  is  called 
UDB. DATABASE,  then  the  set  command  must  be 
speficied  as: 

SET  DB=UDB. DATABASE 

The  EXEC  NEWDB  command  is  only  necessary  for  the 
initial  creation  of  the  database  and  is  not  needed 
subsequently. 

To  run  the  analyzer  and  have  the  ability  to 
use  the  URA  command  language,  the  following 
command  should  be  given: 

EXEC  URA 

URA  will  come  back  with  a short  message  and  then 
ask  the  user  to  enter  a command. 


Example  URA  Runs 


An  initial  run  might  be: 

LOGON  TSXXXX  SIZE  (246)  PROC  (URA) 

(enter  password  when  prompted) 

EXEC  NEWDB  DBNAME. DATABASE 
EXEC  URA 

SET  DB= DENAME. DATABASE 

INPUT-URL  INPUT=INP. DATA  XREF  UPDATE 

NAME-GEN  ALL 

FPS 

STOP 

LOGOFF 

A subsequent  run  may  enter  more  input  and 
generate  some  reports: 

LOGON  TSXXXX  SIZE  (246)  PROC  (URA) 

(enter  password  when  prompted) 

EXEC  URA 

1 (attention  interrupt) 

EDIT  OUTPUT. DATA  NEW 
) blank  line  RETURN) 
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EXEC  CLI 

SET  DB=DBNAME. DATABASE  OUTPUT=OUTPUT. DATA 

INPUT-URL  INPUT= SOME. DATA  UPDATE 

NAME-GEN  PROCESS 

PICTURE 

NAME -GEN  ALL 

FPS 

STOP 

LOGOFF 


The  user  could  then  have  the  dataset 
OUTPUT. DATA  printed  out  on  a high  speed  printer  to 
get  all  the  information  from  the  above  reports. 


APPENDIX  B 


URA  Command  Abbreviations 


This  appendix  presents  all  commands,  and  parameters  to  these  commands, 
for  URA.  It  also  presents  the  acceptable  abbreviations  for  these  commands 
and  parameters  on  the  right  hand  side. 


Command  Name 
CHANGE-TYPE 


Parameters 


CONS I STS -COMPARISON 


CONS I STS -MATRIX 


CONTENTS 


DATA-BASE-STATISTICS 


DATA- PROCESS 


Abbreviations 

CT 


FILE 

F 

NAME 

N 

TYPE 

T 

CNC. 

FILE 

F 

CM 

FILE 

F 

NAME 

N 

CONTAINED 

CNTD 

CONSISTS 

CSTS 

CONT 

FILE 

F 

NAME 

N 

INDEX 

NOINDEX 

LEVELS 

NCFLAG 

NONCFLAG 

DBS 

NAMES 

NONAMES 

NUBS 

NONUBS 

NAMNUBS 

NONAMNUBS 

SYNONYMS 

SYN 

NOSYNONYMS 

NSYN 

DP 

FILE 

F 

NAME 

N 

DATA 

D 

PROCESS 

P 
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Coinmancl  Name  Parameters 

DELETE 

FILE 

NAME 

DELETE-COMMENT-ENTRY 

DERIVATION 

DESCRIPTION 

FALSE-WHILE 

PROCEDURE 

TRUE-WHILE 

VOLATILITY 

VOLATILITY-MEMBER 

VOLATILITY-SET 

FILE 

NAME 

PRINT 

NOPRINT 

DELETE- URL 

INPUT 

SOURCE 

NOSOURCE 

XREF 

NOXREF 

DICTIONARY 

FILE 

NAME 

INDEX 

NOINDEX 

NUM-SPACE 

DESCRIPTION 

NODESCRIPTION 

KEYWORDS 

NCKEYWORDS 

RESPONSIBLE-PD 

NORESPONSIBLE-PD 

SYNONYMS 

NOSYNONYMS 


Abbreviations 

DEL 

F 

N 

DCOM 

DER 

DESC 

FW 

PRCD 

TW 

VOL 

VOLM 

VOLS 

F 

N 

NP 

DURL 

I 

S 

NS 

X 

NX 

DICT 

F 

N 


NS 

DESC 

NDESC 

KEY 

NKEY 

RPD 

NRPD 

SYN 

NSYN 
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ENTITY-IDENTIFIER 

FILE 

NAME 

IDENTIFIER 

ENTITY 

FORMATTED-PROBLEM-STATEMENT 

AMARG 

BMARG 

COMMENT 

NOCOMMENT 

CMARG 

DEFINE 

NODEFINE 

DESG 

NODESG 

EMPTY 

NOEMPTY 

FILE 

NAME 

HMARG 

INDEX 

NOINDEX 

NEW-LINES 

NONEW-LINES 

NEW-PAGE 

NONEW-PAGE 

NMARG 

ONE-PER-LINE 

SEVERAL-PER-LINE 

PRINT 

NOPRINT 

PUNCH 

NOPUNCH 

RNMARG 

SMARG 


El 

F 

N 

I 

E 

FPS 

AM 

BM 

COM 

NCOM 

CM 

DEF 

NDEF 

DG 

NDG 


F 

N 

HM 


NL 

NNL 

NPG 

NNPG 

NM 

OPL 

SPL 

NP 

P 

RM 

SM 
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Command  Name 

FREQUENCY 

HELP 


INPUT- URL 


KWIC 


NAME-GEN 


Parameters 


Abbreviati  ons 


FREQ 

1 

comnand-name 

SHORT 

LONG 

IP 

DBREF 

D 

NODBREF 

ND 

INPUT 

I 

SOURCE 

S 

NOSOURCE 

NS 

UPDATE 

U 

NOUPDATE 

NU 

XREF 

X 

NOXREF 

NX 

FILE 

F 

DIF 

NG 

ATTRIBUTE 

ATTR 

NOATTRIBUTE 

NATTR 

ATTRIBUTE-VALUE 

ATTV 

NOATTRIBUTE-VALUE 

NATTV 

CONDITION 

COND 

NOCONDITION 

NCOND 

ELEMENT 

ELE 

NOELEMENT 

NELE 

ENTITY 

ENT 

NOENTITY 

NENT 

EVENT 

EV 

NOEVENT 

NEV 

GROUP 

GR 

NOGROUP 

NGR 
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Command  Name 
NAME-GEN  (cont'd) 


Parameters 


Abbrevi ati ons 


INPUT 

INP 

NOINPUT 

NINP 

INTERVAL 

INT 

NOINTERVAL 

NINT 

KEYWORD 

KEY 

NOKEYWORD 

NKEY 

MAILBOX 

BOX 

NOMAILBOX 

NBOX 

MEMO 

NOMEMO 

NMEMO 

OUTPUT 

OUT 

NOOUTPUT 

NOUT 

PROBLEM-DEFINER 

PD 

NOPROBLEM-DE FINER 

NPD 

PROCESS 

PROC 

NOPROCESS 

NPROC 

REAL-WORLD-ENTITY 

RUE 

NOREAL-WORLD-ENTITY 

NREW 

RELATION 

RLN 

NORELATION 

NRLN 

SECURITY 

SEC 

NOSECURITY 

NSEC 

SET 

NOSET 

SOURCE 

SRC 

NOSOURCE 

NSRC 

SUBSETTING-CRITERION 

SSCN 

NOSUBSETTING-CRITERION 

NSSCN 

SYNONYMS 

SYN 

NOSYNONYMS 

NSYN 

SYSTEM-PARAMETER 

SYSP 

NOSYSTEM-PARAMETER 

NSYSP 

UNDEFINED 

UNDF 

NOUNDEFINED 

NUNDF 
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Command  Name 


Parameters 


Abbreviati ons 


NAME-GEN  (cont'd) 

BASIC 

NOBASIC 

EMPTY 

NOEMPTY 

KEY 

IDENTIFIER  ID 

IDENTIFIER-GROUP  IDG 

IDENTIFIER-ELEMENT  IDE 


NONE 

ALL 

ORDER 

PD 

PRINT 

NOPRINT  NP 

PUNCH  P 

NOPUNCH 
TOTAL 

SUBLEVEL  SL 

SUBPARTS-OF  SO 

NAME-LIST  NL 

ORDER-ALPHA 

ORDER=BYTYPE 

PICTURE  PIC 

DATA  D 

NODATA  ND 

FILE  F 

NAME  N 


FLOW 

NOFLOW 

INDEX 

NOINDEX 

STRUCTURE  STR 

NOSTRUCTURE  NSTR 
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Command  Name  Parameters  Abbreviations 

PRINT-ATTRIBUTE-VALUES  PAV 

FILE  F 

NAME  N 

PROCESS-INPUT-OUTPUT  PRIO 

FILE  F 

NAME  N 

DESCRIPTION  DESC 

NODESCRIPTION  NDESC 

PROCEDURE  PRCD 

NOPROCEDURE  NPRCD 

INPUT  INP 

NOINPUT  NINP 

OUTPUT  OUT 

NOOUTPUT  NOUT 

NEW-PAGE  NPG 

NEU-PAGE  NNPG 

PRINT 

NOPRINT  NP 

PUNCH  P 


NOPUNCH 

EMPTY 

NOEMPTY 

INDEX 

NOINDEX 


PUNCH-COMMENT-ENTRY  PCOM 

DERIVATION  DER 

DESCRIPTION  DESC 

FALSE -WHILE  FW  » 

PROCEDURE  PRCD 

TRUE -WHILE  TW 

VOLATILITY  VOL  • 

VOLATILITY-MEMBER  VOLM 

VOLATILITY-SET  VOLS 

EMPTY 
NOEMPTY 

FILE  F * 

NAME  N 
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Corr.mnirl  Damn 

PUNCII-OOMMEIIT -ENTRY  ( eont  ’d) 


RENAME 


REPLACE-COMMENT -ENTRY 


LET 


STOP 

STRUCTURE 


NUMMARY 


Pa rnmetern 

Abbreviations 

PRINT 

NO PRINT 

NP 

PUNCH 

P 

NOPUNCH 

REN 

INPUT 

I 

OLD 

0 

NEW 

N 

RCOM 

INPUT 

I 

PRINT 

NOPRINT 

NP 

ECHO 

E 

INPUT 

I 

LINES 

L 

OUTPUT 

0 

PROMPT 

P 

STR 

INDENT 

IND 

INDEX 

IND 

NO INDEX 

INPUT 

INP 

OUTPUT 

OUT 

PROCESS 

PROC 

REAL-WORLD-ENTITY 

RWE 

SUM 
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01  on nary 


comment  entry 


The  text  associated  with  a comment  entry  statement. 
PESCRIPTION,  PROCEDURE  and  VOLATILITY  are  examples  of 
comment  entry  statements. 


comment  entry 
statement 


Any  URL  statement  which  allows  the;  contents  of  the  state- 
ment to  be  defined  by  the  user  (as  is  narrative  description). 
The  DESCRIPTION  and  PROCEDURE  statements  are  examples 
of  this. 


Control  Command 


A URA  command  which  passes  control  information  to  URA . 
STOP  and  SET  are  Control  Commands. 


conversational 

mode 


Used  synonymously  with  on-line  mode.  Refers  to  inter- 
active use  of  the  computer  system  through  a terminal 
device . 


database 


Synonymous  with  "URA  database".  This  is  the  information 
stored  and  retrieved  by  URA  by  means  of  the  Modifier 
and  Report  Commands. 


data  object 


Any  URA  name  type  that  represents  some  form  of  data. 
SETS , INPUTS , OUTPUTS,  ENTITIES,  GROUPS  and  ELEMENTS 
are  all  data  objects  described  by  URL. 


device 


Input-output  peripheral  equipment;  for  example,  a card 
reader,  magnetic  tape  drive,  terminal,  etc. 


dsname 


Any  legal  dataset  name  that  is  to  be  specified  by  the 
user. 


ESD  TR //  75-88  , Vol  I I'URL  User  Manual",  Version  3.0.  This  manual  specifies 

and  defines  all  the  URL  statements  processable  by  URA, 
their  purpose,  syntax,  etc. 


ESD  TR ft  75-83  ,VolI  "An  Introduction  to  Computer  Aided  Requirements  Analysis". 


header  section 


Any  of  the  statements  allowed  in  URL  that  specify  the 
beginning  of  a set  of  statements  describing  the  user 
defined  names  specified  in  this  statement.  See  Appendix 
F of  ESD  TR^  (75-88,  ) for  a complete  list  of  all 

section  types.  VolII 


input  1‘ilc 
mode 


Any  dataset  which  contains  data  to  be  used  by  URA  com- 
mands via  INPUT  or  FILE  parameters. 


T*  rm  used  synonymously  with  "pr  iccssing  mode"  which 
r>  1'ers  to  a state  where  the  user-  has  a particular  set 
of  operations  available  to  perl'  >rm  required  tasks. 
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V-  ■ ; ' - 

Modifier  Command 
name  type 

Report  Command 

undefined  name 
URA 

URA  command 

URA  database 
URA  "object" 

URL 

URL  statements 
user  requirement 


Any  URA  command  which  niters  the  contents  of  the  user's 
U;tA  database. 


Any  of  the  many  types  of  names  allowed  in  IJRL  (i.e.,  FROCK; 
OKT,  GROUP,  etc.).  Gee  ECU  TR//  (75-88,  Vol)  ^ ..(mL 
Users  Manual",  Appendix  E for  a list  of  ail  possible 
name  types. 


Any  command  available  on  the  URA  system  whose  cole  pur- 
pose is  to  retrieve  information  from  the  user's  URA 
database. 


A name  that  has  been  entered  into  the  URA  database,  but 
has  no  name  type  asspeiated  with  it. 

The  User  Requirement  Analyzer.  Synonym  is  "Analyzer". 
Software  package  which  retrieves  and  inputs  information 
to  the  URA  database. 

Any  of  the  commands  that  can  be  used  to  operate  URA. 

See  Appendix  I for  complete  descriptions  about  each 
command  available  on  URA. 

Area  where  URL  information  is  stored  (in  a coded  format) 
which  can  then  be  accessed  by  the  commands  allowed  by  URA. 

Synonymous  with  "name  types".  Any  of  the  objects  that 
can  be  defined  by  URL  (a  SET,  a GROUP,  a PROCESS  are  all 
objects  in  URA).  Usually  referred  to  as  just  "object" 
in  this  paper. 

Acronym  for  "User  Requirement  Language"  which  is  the 
collection  of  ail  URL  statements  allowed  for  use  by  URA. 
See  EGD  TR//  ( 75-88, Vol  por  complete  descriptions  of 
al L statements  available . 

Those  statements  specified  by  ESD  TR#  ( 75-88, Vol 
The  statement  presents  one  aspect  of  description  for  a 
particular  URA  "object". 

A set  of  requirements  specified  by  users  of  a proposed 
system  and  interpreted  by  the  user  into  a format  ac- 
ct  ptable  by  the  organization. 


I n t roHuc  t i on 


This  part  is  intended  as  a ^uide  to  unders tand i n^ 
the  purpose  of  all  outputs  generated  by  the  User 
°Qotji  rempnts  Analyzer  (URA).  It  Illustrates  how  each 
outnut  is  to  be  used  and  nost  of  all,  how  it  fits  into 
the  reouirements  specification  process.  It  assumed 
t h t the  r eg  de  r is  familiar  with  the  concents 
concerning  URL/I.'RA  as  presented  in  ESP  TP  75-flR,  Vol  I, 
"Introduction  to  Computer  Aided  Retirements  Analysis". 
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OBJECTIVES  OF  OUTPUTS  FOR  A URA  DATA  BASE 

There  are  two  major  objectives  in  logical  system  design: 

- To  produce  a proposed  system  that  is  the  best  possible 
in  terms  of  what  it  will  cost  to  build,  cost  to  operate 
and  what  it  will  contribute  to  the  organization. 

- To  minimize  the  cost  and  time  to  produce  this  "optimum" 
target  system. 

The  objective  of  developing  computer-aided  methods  for  use  in 
logical  system  design  is  to  contribute  to  the  above  objectives. 

At  the  present  time,  it  is  not  possible  to  achieve  an  optimum 
solution  for  both  of  these  objectives.  One  contribution  that  can 
be  made  by  a computer-aided  method  is  to  improve  the  "quality"  of 
the  description  of  the  target  system.  Quality  is  defined  in  terms 
of  consistency,  unanbiguity  and  completeness. 

Consistency  means  that  no  statements  made  in  the  description 
contradict,  or  are  incompatible  with,  otner  statements  and  that 
any  particular  object  is  referred  to  by  the  same  name  throughout 
the  description. 

Unambiguity  means  that  statements  and  relationships  are  made  so 
precisely  that  interpretation  is  uniform  by  all  readers. 

Completeness  means  that  all  necessary  relationships  are  given 
and  no  objects  have  been  omitted  from  the  description.  The  quality 
objectives  can  be  aided  at  three  levels: 

1.  URA  will  enforce  consistency  and  unambiguity  through  the 
syntax  analysis  and  reference  checks  made  when  data  is 
entered  into  the  URA  data  base. 

2.  The  URA  outputs  will  make  it  easier  for  the  user  to  detect 
logic  errors  in  the  user  requirements,  unresolved  conditions, 
etc. 

3.  Some  outputs  are  available  to  the  user  to  aid  in  detecting 
incompleteness  and  inconsistencies  of  the  user  requirements. 

The  second  objective,  that  of  minimizing  design  cost  and  time, 
is  aided  by  transferring  much  of  the  clerical  workload  to  the 
computer.  The  Analyzer  (URA)  maintains  an  up-to-date  record  of 
all  data  collected.  The  preparation  of  this  data  for  use  by 
analysts*,  management,  etc.  can  be  readily  retrieved  at  request. 

To  meet  these  objectives,  URA  offers  three  classes  of  outputs: 


*N0TE:  throughout  this  paper,  the  terms  analyst  and  user  are  used 

synonymously. 
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- Reports  to  aid  the  analyst 


- Reports  to  aia  project  management 

- Final  specifications 

Outputs  to  aid  the  analyst  are  basically  those  reports  which  aid 
in  resolving  inconsistencies,  ambiguities,  and  incompleteness 
in  the  logical  system  design  user  requirements  (See  Sections  7 
7 and  15.) 

The  outputs  of  concern  to  project  management  pertain  to  status 
of  the  project  in  t.ie  form  of  amount  of  information  ente rea  into 
the  URA  data  base,  etc.  (See  Section  16.) 

The  final  specifications  are  the  end  result  of  the  logical  system 
design  prase  using  URL/URA.  They  express  all  the  information  in 
the  URA  c.. :a  base  in  an  easy-to-read  format.  These  specifications 
are  intended  to  oe  self-contained  and  not  to  require  any  additional 
reports  to  explain  their  contents. 


2.  TYPES  OF  URA  OUTPUTS 

2.1  The  URA  Command  Language* 

All  data  in  a URA  Data  Base  is  accessed  and  retrieved  via  the 
URA  Command  Language  (see  Part  II  )•  The 

Command  Language  offers  three  types  of  commands: 

- Report  Commands 

- Modifier  Commands 

- Control  Commands 

Report  Commands  retrieve  data  from  the  (JRA  data  base  and  output 
this  data  in  some  designated  format.  FORMATTED-PRCBLEM-STATEMENT 
and  PICTURE  are  typical  Report  Commands. 

Data  Base  Modifier  Commands  do  something  to  change  the  contents  of 
the  URA  data  base.  The  outcome  of  the  modification  is  always 
presented  by  URA  it  zha  form  of  some  output  report.  INPUT-UP1  is 
a Modifier  Command  which  generates  the  URA  A3-IS  SOURCE  LISTING 
and  the  URA  CROSS  REFERENCE,  if  requested.  The  contents  of  the 
URA  Ai-IS  SOURCE  LISTING  verifies  that  the  modifications  were 
made  by  the  Analyzer  and/or  some  errors  were  encountered. 

The  remaining  commands  relay  control  information  to  URA.  SET  and 
STOP  are  obviously  Control  Commands.  URA  does  not  generate  any 
output  for  Control  Commands  unless  an  error  is  encountered. 


*A  complete  list  of  the  URA  Commands  available  to  the  user  of 
URA  can  be  found  in  Part  II  . 


Though  each  command  can  be  issued  independently  it  is  often 
advantageous  to  use  some  commands  in  sequence  in  that  output  of 
one  command  functions  as  input  to  another.  The  most  common 
instance  of  this  is  when  NAME-GEN  (NG)  is  used  to  select  certain 
names  (say  all  PROCESSES  for  example)  which  are  then  used  as 
input  to  a Report  Command  (possibly  PICTURE  (PIC),  to  produce, 
the  PICTURE  report  for  all  PROCESS  names). 

2.2  Reports 

Inquiries  on  the  data  base  are  implemented  in  the  same  manner  as 
reports.  An  inquiry,  in  URA,  is  simply  a report  for  a single  name. 
(MeSt  Report  Commands  have  NAME  and  FILE  parameters  for  this  purpose.) 
This  capability  reduces  the  complexity  of  learning  several  different 
types  of  commands  for  different  modes  of  retrieval.  Retrieval 
criteria  for  any  given  report  can  be  determined  with  respect  to 
any  combination  of  the  following: 

- By  Name  type  (retrieve  all  PROCESSES,  for  example) 

- By  USER  (retrieve  all  designated  objects  defined  by  a 

particular  user) 

- By  KEYWORD  (retrieve  all  designated  objects  identified  by 

the  appropriate  KEYWORD) 

- By  SUBPARTS  for  a particular  object  (retrieve  all 

designated  information  for  those  names  defined 
as  being  a SUBPART  of  a specified  object. 

The  object  must  be  a PROCESS,  INPUT,  OUTPUT 
or  REAL-WORLD-ENTITY). 

The  retrieval  criteria  allows  the  analyst  to  be  completely 
selective  in  the  contents  of  the  output  reports.  This  means  that 
the  user  gets  no  more,  no  less,  than  the  requested  Information. 

2.3  Special  Analysis 

Besides  the  analysis  done  automatically  by  URA  to  check  for 
consistency,  unambiguity  and  completeness,  URA  offers  Problem 
Analysis  reports  to  check  for  these  qualities  after  data  is  stored 
in  the  data  ba$e.  The  purpose  of  these  "special  analyses"  is  to 
perform  quality  checks  on  the  user  requirements,  viewing  it  as  the 
final  specifications,  to  aid  the  analyst  in  improving  this 
documentation.  (Automatic  analysis  is  done  by  Modification  Commands 
to  perform  quality  checks  on  data  as  it  is  input  into  URA.) 

2.4  Own  Reports 

The  reports  described  in  the  following  sections  are  by  no  means 
considered  exhaustive  of  the  capabilities  of  URL/URA.  For  any 
particular  organization,  reports  specific  to  its  needs  can  easily 
be  implemented  by  the  report  generation  process  documented  in 
ISDOS  Working  Paper  No.  100. 


3. 
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URA  OUTPUT  AND  ANALYSIS  CAPABILITY  CLASSIFIED  BY  LEVEL  OF  COMPLEXITY 

URA  provides  clerical  aids  and  rapid  retrieval  capabilities  for 
its  users  by  permitting  the  data  which  is  collected  during  the 
logical  system  design  process  to  be  made  available  from  a data 
base,  thus  descreasing,  and  hopefully  eliminating,  the  need  for 
manually  maintained  records.  Since  the  information  is  maintained 
in  a data  base,  this  implies  that  a user  must  be  able  to  display 
this  information  in  various  ways  to  satisfy  the  needs  of  the 
user.  The  software  also  provides  for  the  adding  of  new  information, 
the  deleting  of  unwanted  information  and  the  updating  of  current 
information  about  the  target  system. 

The  functions  for  output  and  analysis  of  URA  may  be  classified  in 
order  of  increasing  complexity  as  follows: 

Record  and  Display 

Any  data  gathered  by  the  user  and  expressed  in  URL  can  be 
entered  into  the  data  base  and  displayed  as  required.  The 
read  process,  involves  semantic,  and  syntax  checks  to  be 
performed  on  the  input  data.  Diagnostics  are  given  when 
errors  occur  in  these  checks. 

Rearrange  and  Format 

Any  data  in  the  data  base  can  be  rearranged,  sorted,  and 
formatted  to  satisfy  external  documentation  requirements. 

The  FORMATTED  USER  REQUIREMENTS  is  an  example  of  this 
capability.  Checks  are  made  that  the  requested  information 
is  available  and  that  the  names,  for  which  the  retrieval 
is  to  be  doen,  exist  in  the  URA  data  base. 

Checking 


URA  performs  an  "in  context"  check  of  all  data  input  into  the 
data  base.  This  makes  certain  that  any  name  in  the  data  base 
is  used  consistently  throughout  the  requirements  definition. 

The  URA  AS-SOURCE  LISTING  from  the  INPUT-URL  command  illustrates 
this  function.  A large  number  of  consistency  checks  are  made 
which  all  generate  error  messages  when  they  fail.  For  example, 
checks  are  made  so  that  a name  defined  as  a GROUP  is  not  used 
as  PROCESS,  etc. 

Analysis 

The  User  Requirements  Statement  Analyzer  will  provide  more 
extensive  analysis  of  the  relationships  that  exist 
between  all  data  and  processes  than  a human  analyst  can. 

The  sheer  size  and  complexity  of  today's  information 
processing  systems  does  not  permit  any  analyst  or  group  of 
analysts  to  accomplish  this  task  in  any  amount  of  time 
that  will  not  delay  the  operational  status  of  the  target  system. 
The  analysis  is  performed 
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on  the  user  requirements  and  can  lead  to  simplication 
of  the  user  requirements  through  restructuring  and 
grouping,  etc.  The  analysis  is  carried  as  far  as 
practical  without  bringing  in  physical  implementation 
considerations  such  as  file  structures,  report  formats, 
hardware  characteristics,  etc.  The  matrix-generating 
reports  illustrate  this  function.  This  type  of  analysis 
generates  error  messages  and  warnings  when  specific 
"completeness"  criteria  might  fail.  For  example,  a 
GROUP  might  be  flagged  if  it  did  not  consist  of  any 
GROUPS  or  LEMENETS.  (By  definition,  a GROUP  must 
consist  of  other  items.) 


USE  OF  URA  OUTPUTS  AND  REPORT  DESIGN  CRITERIA 


Use  of  URA  Outputs 


URA  outputs  are  designed  to  accomplish  one  or  more  of  the 
following  objectives: 


1. 


Aid  the  user  in  communicating  with  users.  The  users  are 
defined  to  be  those  people  who  will  benefit  from  the 
proposed  system  when  finished.  As  described  in  ISDOS 
Working  Paper  No.  86,  the  description  of  the  proposed 
system  is  based  on  data  collected  from  users,  and  must 
therefore  be  verified  by  them.  The  adequacy  of  the  pro- 
posed system  must  also  be  verified.  Therefore,  outputs 
must  be  readable  by  the  user  and  include  dictionaries 
and/or  glossaries  to  aid  in  keeping  terminology  consistent. 


2.  Aid  the  user  in  communicating  with  users. 


- Detecting  and  correcting  inconsistencies,  ambiguities, 
etc.,  with  the  data  already  recorded  in  the  URA  data 
base. 


Determining  what  further  data  is  required  to  make 
the  user  requirements  "complete." 


Quick,  easy  and  simple  methods  for  preparing  input 
of  new,  additional  data  and  corrected  data. 


- Provide  a ready  reference  for  what  has  been  done. 


Coordination  in  the  project.  These  reports  are  used  to 
aid  in  coordinating  the  work  of  a number  of  users,  for 
example,  by  global  dictionary  and  directory  facilities. 
Redundancy  of  the  work  effort  is  avoided  by  the  ability 
to  retrieve  current  information  from  the  data  base  to  check 
project  status.  The  dictionary  aids  in  keeping  the  names 
used  and  their  respective  definitions  consistent  throughout 
requirements  definition. 
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Produce  final  specifications.  URA  must  provide  the  complete 
user  requirements  documentation  after  the  users  have 
completed  logical  design  and  all  information  about  it  is  in 
the  data  base.  A final  self-contained  set  of  hard  copy 
documentation  is  produced  for: 

- A permanent  reference 

- Final  validation  for  user  concurrence 

- Specifications  for  the  physical  system  design 

- Anyone  interested  in  understanding  the  system  (for 
those  preparing  training  material,  etc.) 

Consequently  the  documentation  must: 

- Contain  all  information  required  by  organizational 
standards  for  such  documentation 

- Be  an  easy-to-r?'  irmat  which  can  be  presented 
so  that  anyone  fa.,  iar  with  the  designed  system 
can  get  an  understar^'ng  of  it  to  whatever  depth 
they  require. 

- Contain  summaries  and  cross  references  so  that 
objects  can  be  described  at  different  levels  of 
detail  and  all  information  pertaining  to  one  object 
can  easily  be  found. 

5.  Aid  project  management.  Reports  must  be  produced  to  aid 

project  management  in  reviewing  status  and  evaluating  progress 
of  the  design  process  while  using  URL/URA. 


4.2  Design  Criteria  for  an  URA  Report 

In  order  to  serve  the  uses  identified  in  Section  4.1  effectively, 
the  format  of  the  reports  should  satisfy  the  following  criteria: 

1.  Reports  should  be  self-contained  and  explanatory  so  that  they 
can  be  used  by  a user  without  consulting  a manual.  This  can 
be  accomplished  by  dividing  reports  into  three  parts: 

Title  Section 
Detail  Section 

Summary  Section  (when  applicable) 

The  Title  Section  consists  of: 

1 . Name  of  Report 

2.  Date 

3.  Name  of  Problem  (only  if  set  by  user) 

4.  Parameter  values  of  the  comnand  that  generated  the  report 
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The  Detail  Section  is  the  main  body  of  the  report.  It 
usually  displays  a selected  subset  of  the  contents  of  the 
data  base  in  a consistent  format.  Most  of  the  errors 
encountered  In  the  processing  of  the  report  command  have 
their  error  diagnostics  printed  in  this  section  also. 

The  Summary  Section  contains  report  statistics  and  warning 
diagnostics.  As  it  is  not  always  practical,  the  Summary 
Section  is  only  included  in  those  reports  that  such  infor- 
mation might  be  useful.  The  DATA  PROCESS  report  has  a 
Summary  Section,  for  example. 

2,  The  reports  should  efficiently  use  the  available  space, 
for  example,  8-1/2  x 11"  pages,  so  that  they  can  be 
easily  Included  in  the  formal  documentation.  In  other 
words,  the  reports  must  conform  to  the  standards  of  the 
particular  organization's  systems  department. 


URA  OUTPUT  CLASSIFICATION  BY  CONTENTS  AND  RELATIONSHIPS  ANALYZED 

In  previous  sections,  URA  outputs  have  been  classified  by 
various  criteria.  Section  2 classifies  outputs  by  the  type  of 
command  that  generates  it  (i.e..  Modifier  or  Report),  Section  3 
classifies  outputs  on  their  level  of  complexity,  and  Section  4 
on  the  way  the  outputs  are  used.  Finally,  the  most  important 
aspect  of  classifying  outputs  is  by  their  part  in  the  overall 
description  of  the  target  (or  proposed)  system. 

Many  different  outputs  and  reports  could  be  generated  from  URA, 
but  a large  quantity  of  outputs  does  not  necessarily  make  up  a 
quality  target  system.  It  must  be  determined  what  outputs  are 
necessary. 

As  computer-based  information  systems  become  more  and  more  complex, 
it  is  impossible  to  look  at  the  entire  system  at  one  time.  There- 
fore, we  must  look  at  certain  aspects  of  the  system  to  fit  it 
together.  These  aspects  are  the  criteria  for  determining  the 
necessary  outputs. 

The  remaining  part  of  this  section  will  deal  with  the  definition 
of  output  classes  in  the  following  matter: 

1.  What  aspect  of  the  system  description  of  this  class  of 
outputs  aids  to  present. 

2.  Manual  procedures  used  to  obtain  this  class  of  outputs. 

3.  The  specific  outputs  needed  In  this  class  and  how  they 
are  related. 
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5.1  Input  Data  and  Modification  Outputs 

1.  Throughout  the  logical  system  design  phase  of  system 
building,  the  description  of  the  target  system  is  constantly 
under  change.  New  information  is  adced  to  the  description 
and  old  information  is  changed.  In  an  effort  to  keep  track 
of  all  these  updates  to  the  description,  some  documentation 
method  must  be  used. 

2.  In  manual  documentation  methods,  it  is  commonly  the  practice 
to  jot  down  on  a scratch  pad  or  verbally  communicate  to 
others  that  a change  is  being  made  in  the  system  description. 
Many  times  there  is  no  hard  copy  of  the  description  moaifi ca- 
tion and  even  if  there  is,  usually  there  is  no  standard 
procedure  for  doing  so.  Even  when  a standard  form  or  standard 
procedure  is  specified  by  the  organization,  it  is  difficult 

to  enforce  when  the  procedure  for  doing  so  is  manual. 

. 3.  URA  generates  separate  reports  for  each  different  type  of 
modification  to  the  system  description  and  are  as  follows: 

URA  AS- IS  SOURCE  LISTING 
URA  CROSS  REFERENCE 
CHANGE-TYPE  REPORT 
DELETION  REPORT 
DELETED  COMMENT  ENTRIES 
RENAME  REPORT 
REPLACED  COMMENT  ENTRIES 

5.2  Complete  User  Requirements  Reference* 

1.  At  any  point  in  the  system  description,  it  is  often  necessary 
to  find  out  all  the  relationships  that  have  been  specified  for 
a particular  ooject.  The  reports  or  outputs  to  serve  this 
aspect  of  the  system  description  must  present  all  the  informa- 
tion available  for  any  particular  object. 

2.  If  this  report  were  to  be  generated  from  manually  maintained 
documentation,  it  would  often  be  very  difficult  to  find  all 
information  pertaining  to  a particular  object  unless  the 
documentation  had  adequate  referencing  facilities.  Even  if 
all  information  can  be  found,  it  Is  usually  not  in  one  place. 
When  forms  are  useo  for  this  purpose  they  usually  describe 
objects  such  as  processes  and  do  not  attempt  the  same  for  data 
elements  or  files,  the  maintenance  of  such  documentation 
would  be  very  difficult. 


♦NOTE:  The  term  "user  requirements"  is  synonymous  with 

"system  description"  or  "description  for  the  proposed 
system." 
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3.  The  information  to  be  presented  by  this  class  of  outputs  can 
easily  be  contained  in  one  report,  the  FORMATTED  REQUIREMENTS 
STATEMENT. 

Directories,  Dictionary,  Glossaries  and  KWIC  Index 

1.  The  information  supplied  by  directories,  dictionaries  and 
glossaries  are  necessary  in  coordinating  the  work  effort 
between  several  individuals  as  well  as  presenting  summary 
Information  about  objects  when  the  complete  user  requirements 
refehence  is  too  detailed  or  bulky.  These  outputs  present 
very  selective  information  about  each  object. 

2.  Most  manual  methods  of  system  description  use  a list  of 
names  to  serve  the  purpose  of  directories.  Unfortunately , 
there  is  usually  no  way  to  be  certain  that  the  list  is  up-to- 
date.  The  same  problem  is  encountered  in  manually  maintaining 
a data  dictionary  (or  global  dictionary,  in  general).  The 
majority  of  glossaries  used  are  usually  not  relevant  by  the 
time  the  system  description  is  finisned.  The  KWIC  index  also 
proves  to  be  a problem  to  update.  In  general,  directories 
and  glossaries  are  used  on  an  ad  hoc  basis  in  system 
description  where  forms  are  used  for  the  dictionary  and 

KWIC  index. 

3.  The  outputs  needed  to  satisfy  this  aspect  of  the  system 
description  would  be  in  the  format  of  name  lists,  name 
Indices,  and  data  definition  dictionaries.  The  two  outputs: 

NAME  GEN 
URA  NAME  LIST 

allow  selective  name  lists  to  be  generated  and  formatted  as 
reports.  The 

URA  KWIC  INDEX 

is  a report  which  is  an  index  into  the  names  in  the  URA 
data  base  basea  on  the  keyword  identifiers  within  that  name. 
The  two  outputs: 

DICTIONARY  REPORT 
PUNCHED  COMMENT  ENTRIES 

provided  summary  Information  to  serve  as  dictionaries  or 
glossaries  to  the  user  requirements. 

Structure 


Another  aspect  of  the  target  system  that  must  be  presented 
is  the  structure  of  various  objects  within  the  system.  For 
example,  as  an  aid  to  the  physical  system  designer,  it  must 
be  known  hew  records  relate  to  files  and  what  data  is  to  be 
stored  within  these  records.  This  specific  information  is 
necessary  in  constructing  the  data  structures  for  the  target 
system. 


2.  Usually  charts  are  used  to  present  the  organizational  structure 
or  to  illustrate  process  interrelationships.  Narrative 
description  is  also  used  tut  neither  usually  follow  any  standard 
procedure  for  doing  so.  Sometimes  structure  forms  (wnich  present 
a cross  listing  of  low  levels  of  data  into  larger  groups)  are 
used  but  this  becomes  extremely  difficult  to  modify  especially 
when  items  are  contained  in  several  larger  groups  unless  an 
adequate  cross  reference  listing  of  this  information  is 
available. 

3.  Of  the  outputs  available  for  presenting  structure  within  the 
target  system,  the  following  outputs  illustrate  physical  and 
logical  structures  specified  by  the  user. 

CONTENTS  REPORT 
STRUCTURE 

INTERVAL  STRUCTURE 
PICTURE 

PICTURE  presents  the  information  available  by  CONTENTS  and 
STRUCTURE  but  as  a graphical  output.  Outputs  that  present 
data  and  file  relationships  and  aid  to  optimize  their  structures 
are  the  following: 

CONSISTS  MATRIX 

~ IDENTIFIER  INFORMATION  REPORT 

RELATION  INFORMATION  REPORT 

5.5  Flow 

1.  Another  aspect  of  the  system  that  is  required  for  a complete 
description  is  information  pertaining  to  how  documents  and 
data  are  used  throughout  the  system.  What  is  to  be  used  as 
input  at  any  particular  phase  of  operation,  and  what  are  the 
outputs,  are  two  of  the  questions  to  be  answered. 

2.  Flow  charts  and  various  diagrams  are  the  most  corranon  methods 
of  presenting  this  information  manually.  In  large  systems, 
this  manner  of  documenting  gets  extremely  bulky  (hundreds  of 
pages  of  flew  cnarts)  and  even  more  difficult  to  update  or 
index.  In  many  cases,  the  narrative  in  the  rest  of  the  system 
description  dees  not  correspond  to  the  flow  charts.  Though 
some  computer-aicod  flow  cnarting  packages  have  been  developed 
they  are  usually  too  restrictive  to  be  worth  the  trouble  of 
Implementing  them. 

3.  The  flow  information  presented  by  these  outputs  should  vary  in 
content  by  illustrating  the  relationships  of  different  levels 
of  objects.  One  may  enly  be  interested  in  tne  information  flow 
at  the  data  el  ament  level  and  not  at  the  file  level.  For  this 

_ reason,  the  following  outputs  are  deemed  necessary  to  present 

the  aspect  of  information  flow: 
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PICTURE 

DATA  PROCESS  REPORT 
PROCESS  INPUT/OUTPUT 

5.6  Dynamic  Analysis 

1.  The  dynamic  analysis  aspect  of  system  description  is  necessary 
in  presenting  the  manner  in  which  the  system  changes  over  time. 
Questions  to  be  answered  here  are:  how  often  is  the  system 

to  perform  a certain  function,  and  when?  The  system  will  be 
designed  much  differently  if  the  objective  is  to  proauce  a report 
once  a year  or  six  reports  a day. 

2.  Unfortunately,  not  enough  i6  done  in  most  manual  methods  of 
documentation  to  present  this  aspect  of  the  system 
description.  Usually  any  information  pertaining  to  the 
dynamics  of  the  system  are  specified  (or  merely  implied)  in 
the  narrative  descriptions  of  various  objects  in  the  documenta- 
ti  on. 

3.  There  are  basically  two  aspects  to  dynamic  analysis.  They  are 

finding  out:  1)  "when"  does  something  happen,  and  2)  "how 

often"  does  it  happen.  Those  outputs  with  information  pertaining 
to  "when"  are: 


EVENT/CONDITION  REPORT 
DYNAMIC  ANALYSIS  REPORT 

Those  outputs  with  information  pertaining  to  "how  often"  are: 

FREQUENCY 

DYNAMIC  ANALYSIS  REPORT 


5.7  Size  and  Volume 

1.  Another  major  aspect  of  system  design  that  must  be  taken 
Into  consideration  is  that  of  system  size  and  volume  of 
processing  to  be  done.  This  aspect  has  a tremendous  influence 
on  how  the  system  is  to  be  built.  The  size  of  the  system  can 
make  the  difference  between  batch  or  on-line  processing. 

The  volume  ana  size  also  sets  restrictions  on  cpu  and  memory 
size,  etc. 

2.  Again,  most  of  this  Information  is  merely  contained  in  the 
descriptions  of  various  objects  in  the  system  description  ana 
not  located  conveniently  for  analysis. 

3.  The  three  major  areas  that  must  be  described  with  respect 
to  size  are: 
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system  parameters 
files 

processing 


The  URA  outputs  which  handle  system  parameters  are: 

SYSTEM  PARAMETER  ANALYSIS 
SYSTEM  PARAMETER  SIZE 

which  present  size  information  such  as  range  of  values,  etc. 
The  output: 


SET  SIZE  REPORT 

specifies  information  relating  to  the  size  of  SETS  (or  files) 
in  tne  system.  Finally, 

PROCESSING  VOLUME  REQUIREMENTS 

presents  information  about  how  often  a process  is  initiated 
and  how  much  information  is  handled  by  this  process. 

.8  System  Properties 

1.  Aside  from  the  cescription  of  individual  objects  in  the 
user  requirements  there  exists  the  need  of  outputs  to  present 
various  properties  of  the  system  concerning  cost,  implementation 
and  anything  else  relevant  in  latter  phases  of  the  system 
building  process.  This  category  includes  outputs  as  a result 
of  special  analyses  related  to  workload  estimation  and  cost/ 
benefit  analysis,  etc. 

2.  There  often  exists  standard  format  for  specifying  such  informa- 
tion but  unfortunately,  relatively  few  standard  tecnniques  for 
deriving  this  information.  As  a result,  these  reports  are 
written  in  an  ad  noc  manner,  rarely  accurate  and  consequently 
of  little  value.  Another  major  problem  is  encountered  when 
attempting  to  extract  such  information  from  a manually  main- 
tained user  requirement.  Inconsistent  or  incomplete  informa- 
tion leads  to  an  inaccurate  system  property  report. 

3.  The  basic  output  from  which  most  of  the  other  "special  analysis" 
outputs  can  be  derived  Is  the 

ATTRIBUTE  REPORT 

One  set  of  outputs  currently  being  developed  to  generate  a 
cost/benefit  analysis  on  the  present  state  of  the  user 
requirement  are  the 

COST/EFFECTIVENESS  REPORTS 

As  various  technicues  and  algorithms  are  developed  to 
analyze  system  properties  more  outputs  can  be  generated. 
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5.9  Requirements  Analysis 


1.  At  any  stage  in  the  process  of  specifying  the  requirements 
statement  there  is  a need  to  check  that  what  has  been  stated 
Is  "correct"  and  "unambiguous,"  and  what  information  is  needed 
to  make  the  requirements  statement  "complete."  This  is  probably 
one  of  the  most  important  and  most  difficult  aspects  of  the 
logical  design  process  to  accomplish.  The  results  of  latter 
phases  of  the  system  building  process  can  only  be  good  as  the 
final  specification  from  the  logical  design  phase.  By  perform- 
ing sufficient  requirements  analysis  on  the  requirements  state- 
ment the  final  specifications  are  improved. 

2.  As  most  methods  of  logical  system  design  are  done  manually,  any 
requirements  analysis  to  be  done  must  be  accomplished  through 
the  brute  force  method.  By  this  fact  alone,  the  purpose  of 
performing  requirements  analysis  is  many  times  defeated.  It  is 
practically  impossible  to  manually  check  for  inconsistency, 
incompleteness  and  ambiguity. 

3.  Many  outputs  reflect  this  capability  to  check  for  consistency 
and  unambiguity  of  the  requirements  statement.  The  AS-IS  SOURCE 
LISTING  presents  inconsistencies  of  newly  input  data  before 
entered  into  the  URA  data  base.  The  DATA  PROCESS  REPORT  and 
the  CONSISTS  MATRIX  present  incompleteness  information  about  the 
requirements  statement.  The  one  output  designed  specifically  to 
present  this  information,  however,  is  the 

COMPLETENESS/CONSISTENCY  REPORT 
5.10  Project  Management 

1.  Through  the  logical  design  process  the  requirements  definer  team 
must,  at  various  times  in  the  process,  generate  status  reports 
to  project  management.  These  reports  hopefully  show  that  the 
requirements  definer  (or  team)  is  making  progress  in  their  design 
effort.  Quantitative  as  well  as  qualitative  information  per- 
taining to  progress  is  desirable  and  should  be  part  of  the 
project  status  documents. 

2.  There  are  many  standard  forms  used  for  presenting  status  of  the 
project  effort.  The  status  reports  can  then  be  compared  with  a 
PERT  chart  or  CPM  chart  to  measure  progress.  The  problem 
encountered  in  specifying  information  in  the  status  report  is 
how  useful  is  the  work  accomplished  in  approaching  completeness 

of  the  requirements  statement.  When  all  work  is  done  in  narrative 
description  it  is  very  difficult  to  measure  progress. 

3.  The  '■'.ports  generated  by  URA  specifically  for  project  management 
attempt  to  present  status  quantitatively.  Quality  of  the  require- 
ments statement  can  be  implied  by  information  from  these  outputs 
also.  The  two  present  outputs  available  for  project  management 
are: 
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DATA  BASE  STATISTICS 
DATA  BASE  SUMMARY 

6.  OUTPUT  DESCRIPTIONS 

For  each  standard  output  available  by  URA,  this  paper  will,  in  the 
following  sections,  describe  it  based  on  the  following  criteria: 

1 . Name  of  output 

2.  Purpose  - usage  of  the  output  within  the  logical  design  process 

and  to  whom  it  benefits  (i.e.,  analyst,  management, 
etc. ) 

3.  Command  - name  of  the  URA  command  and  the  specific  parameters 

required  to  initiate  this  output 

4.  Options  - variations  of  this  report  available  due  to  manipulation 

of  the  command  parameters 

5.  Contents  and  Order-  what  makes  up  the  detail  and  summary  sections 

of  the  output  and  the  ordering  criteria  for  this 
information 

6.  Analysis  - the  complexity  of  the  analysis  performed  by  URA  to 

generate  this  output  and  the  error  checking 
capabilities  of  the  command  generating  it 

7.  Examples  - copies  of  the  actual  printout  in  order  to  show  the 

physical  features  of  the  output 


7.  INPUT  DATA  AND  MODIFICATION  OUTPUTS 

Any  data  to  be  entered  into  the  data  may  be  punched  on  cards  or 

typed  in  at  a terminal,  depending  on  the  facilities  of  the 

particular  installation.  In  either  case,  a hard  copy  record  of 
the  input  procedure,  the  URA  AS-IS  SOURCE  LISTING,  will  be  produced. 
In  fact,  for  any  type  of  modification  to  the  URA  data  base  via  the 

modifier  commands  specified  in  Part  II  , an 

output  report  will  be  generated  to  given  the  user  a hard  copy 
record  of  the  modification.  These  outputs  can  be  used  by  the 
user  to  manually  check  for  errors  made  in  the  modification  procedure. 


7.1  UFA  AS-IS  SOURCE  LISTING 


Purpose:  This  output  is  a record  of  all  information  input  into 
the  URA  data  base,  and  is  intended  as  an  aid  to  the 
analyst.  It  aids  the  analyst  in  finding  errors  in 
the  input  data  and  produces  error  diagnostics  in 
sufficient  detail  to  aid  the  analyst  in  correcting  these 
errors. 

Conmand:  This  output  can  only  be  produced  by  the  INPUT-URL  command 

with  specification  of  the  SOURCE  parameter. 

Options:  There  are  no  options  available  in  the  production  of  this 

output  that  effect  its  content  or  format. 

Contents  and  Order:  This  output  displays,  line  for  line,  the  data 

used  as  input  to  the  INPUT-URl  conmand.  No  reordering 
is  done  on  the  input  data.  Error  diagnostics  are  also 
printed  in  this  output,  usually  directly  following  the 
line  In  which  the  error  occurred. 

Analysis:  URA  first  performs  syntax  and  semantic  checks  on  each 

input  line  before  any  more  complex  checking  is  performed. 
An  "in  context"  check  is  made  for  each  name  used  as  input. 
If  the  name  is  not  in  the  user's  data  base,  it  is  added. 

If  so,  a check  is  made  to  see  that  the  context  in  which 
the  name  is  used  in  the  new  input  conflicts  with  the 
manner  in  which  the  name  is  used  in  the  data  base.  If 
there  is  no  conflict,  the  new  relationships  stated  by 
the  input  are  entered  into  the  data  base.  If  there  is 
conflict,  an  error  message  will  be  produced  and  URA  will 
skip  to  the  next  input  statement. 
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7.2  URA  CROSS  REFERENCE 

Purpose:  This  output  is  intended  as  an  aid  to  the  analyst  in 

correcting  errors  that  appear  in  the  URA  AS- IS  SOURCE 
LISTING  and  DELETED  URL  outputs,  and  also  to  resolve 
ambiguities  in  assigning  name  types  to  the  undefined 
names  In  the  LISTING.  It  is  instrumental  in  correcting 
errors,  as  any  names  that  were  involved  in  an  error  can 
be  quickly  referenced  to  see: 

All  places  in  the  AS-IS  LISTING  and  DELETED  URL 
where  each  name  is  used. 

The  name  type  assigned  to  that  name. 

From  this  information,  the  analyst  will  be  able  to 
determine  what  information  has  to  be  re-entered  to 
correct  the  error.  Since  the  CROSS  REFERENCE  also 
presents  all  those  names  which  have  an  ambiguous  name 
type  (one  that  was  not  defined  in  previous  input),  the 
analyst  can  resolve  these  ambiguities  by  use  of  the 
CHANGE-TYPE  command  or  INPUT-URL. 

Command:  The  XREF  parameter  must  be  used  in  the  INPUT-URL  or 

DELETE- URL  command  to  get  the  output. 

Options:  There  are  no  options  available  in  generating  this  output. 

Contents  and  Order:  This  output  consists  of  an  alphabetical  list  of 
all  user  defined  names,  i.e.,  non-URL  names  that  appear 
In  the  AS-IS  LISTING  or  DELETED  URL  output.  For  each 
name  that  appears  in  tie  CROSS  REFERENCE,  its  corresponding 
name  type  (as  given  in  the  AS-IS  LISTING  or  DELETED 
output)  is  printed  and  a list  of  all  lines  in  the  AS-IS 
LISTING  or  DELETED  URL  output  where  the  name  appeared 
Is  also  given. 

Analysis:  As  the  CROSS  REFERENCE  is  basically  an  index  into  the 

AS-IS  LISTING  or  DELETED  URL  output,  nothing  much  more 
than  rearranging  and  formatting  is  done  to  generate  this 
output  aside  from  some  method  of  maintaining  the  line 
number  lists  for  the  index. 
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7.3  CHANGE-TYPE  REPORT 


Purpose:  As  for  most  of  the  modifier  outputs,  this  report  is  also 

Intended  to  aid  the  analyst.  It  presents  him  with  a 
permanent  record  of  the  transactions  involved  using  the 
CHANGE-TYPE  coitmand.  This  guarantees  that  any  changes 
via  this  command  will  be  documented  for  future  reference. 
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Command:  This  report  is  generated  any  time  the  CHANGE-TYPE  command 

Is  Issued. 

Options:  No  options  for  this  report. 

Contents  and  Order:  This  report  prints  out  for  each  name  used  as 
input  to  the  CHANGE-TYPE  command,  the  name,  the  old  name 
type  associated  w'th  it  and  the  new  name  type  now 
assigned  to  it.  Any  error  diagnostics  “which  may  occur 
during  the  name  type  change  will  also  be  printed  nere. 

The  names  are  printed  out  in  the  same  order  in  whicn  tney 
were  read  as  input  to  the  CHANGE -TYPE  command  (l.e., 

FIFO). 

Analysis:  To  ascertain  that  legal  changes  are  being  done,  various 

"checking"  facilities  must  be  used  to  produce  this  report. 
For  each  name  type  change,  URA  must  check  to  see  that: 

1)  The  name  whose  name  type  is  to  be  changed  exists 
In  the  data  base. 


11) 


The  assignment  of  the  new  name  type  is  consistent 
with  the  context  in  which  the  name  was  used 
previously. 
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Purpose:  This  report  serves  as  a permanent  record  of  all  names 


that  have  been  deleted  from  the  URA  data  base.  It  is 
Intended  to  aid  the  analyst  in  keeping  track  of 
modifications  to  the  data  base.  Once  there  is  a record 
of  a particular  name  being  deleted,  the  analyst  has  the 
option  of  re-using  these  names. 

Command:  This  report  is  generated  every  time  the  DELETION  command 

Is  Implemented. 

Options:  There  are  no  options  for  this  report. 

Contents  and  Order:  For  each  name  used  as  input  to  the  DELETION 

command,  it  is  printed  out  on  the  report  along  with  some 
message  concerning  the  status  of  the  change  (i.e.,  if 
it  did  or  did  not  work).  The  names  on  the  output  appear 
in  the  same  order  as  read  by  the  DELETION  command  (i.e., 
FIFO). 

Analysis:  The  only  analysis  that  must  be  done  to  generate  this 

report  is  to  check  that  the  name  actually  exists  in 
the  URA  data  base  before  it  can  be  deleted. 


I 
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7.5  DELETED  COMMENT  ENTRIES 

Purpose:  Aid  to  the  analyst  in  serving  as  a hard  copy  record  for 

those  corrment  entries  deleted  from  the  system  description. 
As  stated  before,  it  is  desirable  to  have  all  modifications 
to  the  system  description  documented. 

Command:  This  output  is  generated  by  the  DELETE-COMMENT-ENTRY 

command  with  the  PRINT  parameter  in  effect. 

Options:  There  are  no  options  for  this  output.  No  output  is 

generated  if  the  NOPRINT  parameter  is  specified. 

Contents  and  Order:  For  each  comment  entry  to  be  deleted  from 

the  data  base,  the  following  information  is  printed 
jn  the  output: 

- name  in  the  data  base  to  which  the  comment  entry 
belonged. 

- the  type  of  comment  entry  (i.e.,  DESCRIPTION, 

PROCEDURE,  etc.)  which  is  being  deleted. 

- the  full  text  making  up  the  comment  entry. 

As  in  most  modifier  outputs,  the  order  of  the  output 
names  with  respect  to  the  input  names  is  FIFO. 

Analysis:  The  extent  of  analysis  needed  to  accomplish  the  output 

Is  basically  a rearrangement  and  formatting  of  information 
In  the  URA  data  base.  Checking  is  performed  to  see  if 
the  comment  entry  exists  in  the  data  base  before  it  is 

deleted. 
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7.6  RENAME  REPORT 


Purpose:  To  aid  the  analyst  in  documenting  modifications  in  the 

system  description  pertaining  to  changes  in  naming 
objects  in  the  URA  data  base. 

Command:  Generated  automatically  by  usage  of  the  RENAME  command. 

Options:  No  options  available  for  this  report. 

Contents  and  Order:  For  every  name  changed  by  the  RENAME  command, 

this  report  signifies  what  was  the  "old  name"  which 
appeared  in  the  data  base  and  cne  "new  name"  which  has 
taken  its  place.  When  the  name  change  is  not  successful, 
error  diagnostics  are  also  printed  specifying  the 
cause  of  the  error.  Again,  tne  names  are  printed  on 
the  output  in  the  same  order  as  they  are  read  as  input. 

Analysis:  Some  checking  must  be  done  before  the  name  change  is 

executed.  URA  checks  that: 

- the  old  name  exists  in  the  data  base 

- the  new  name  is  not  already  used  in  the  data  base 

- the  new  name  is  a legal  URL  name  (see  ESD  TR  # )• 


If  any  of  these  requirements  are  violated,- an  error 
comment  will  be  given. 
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7.7  REPLACED  COMMENT  ENTRIES 


m 


Purpose:  This  output  serves  as  a permanent  record  of  changes  to 

comment  entries  within  the  system  description.  This 
is  intended  as  an  aid  to  the  analyst. 

Command:  This  output  is  generated  by  the  REPLACE-COMMENT-ENTRY 

conmand  with  the  PRINT  parameter  in  effect. 

Options:  The  only  option  is  not  having  the  output  printed  by 

specifying  the  NOPRINT  parameter. 

Contents  and  Order:  For  each  "old  comment  entry"  to  be  replaced, 

the  output  prints  out,  in  the  following  order: 

- name  to  which  the  "old  comment  entry"  belongs 

- the  type  of  comment  entry  which  is  being  changed 

- the  entire  text  of  the  "old  comment  entry" 

- the  entire  text  of  the  "new  comment  entry"  which 
replaces  the  old  one 

An  error  diagnostics  referring  to  problems  encountered 
in  executing  the  consr.and  are  also  printed  nere. 

Analysis:  The  extent  of  analysis  performed  is  basically  rearrange- 

ment and  formatting  of  information  in  the  data  base 
after  a check  has  been  made  to  ascertain  that  the  "old 
comment  entry"  exists  in  the  data  base  and  the  "new 
comment  entry"  is  legal  for  the  particular  application 
being  used  (i.e.,  not  attempting  to  enter  a PROCEDURE 
comment  entry  for  a SET  name). 


J'Jl  ft,  1S74  16:01. 
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7.8  DELETED  URL 


Purpose:  This  output  is  a record  of  all  information  (besides 

names  and  corment  entries)*  deleted  from  the 
data  base.  It  aids  the  analyst  in  finding  errors 
In  the  deletion  procedure  and  produces  error 
diagnostics  in  sufficient  detail  to  aid  the  analyst 
in  correcting  these  errors. 

Comnand:  This  output  can  only  be  produced  by  the  DELETE-URL 

command  with  the  SOURCE  parameter  in  effect. 

Options:  There  are  no  options  available  in  the  production  of 

this  output  that  effect  its  contents  or  format.  If 
the  output  Is  not  desired,  the  NOSOURCE  parameter  may 
be  given. 

Contents  and  Order:  This  output  displays,  line  for  line,  the  data 

used  as  input  to  the  DELETE-URL  command.  No  reordering 
is  done  on  the  input  data.  Error  diagnostics  are  also 
printed  in  this  output,  usually  directly  following  the 
line  in  which  the  error  occurred. 

Analysis:  URA  first  performs  syntax  and  semantic  checks  on  each 

Input  line  before  any  more  complex  checking  is  performed. 

An  "in  context"  check  is  made  for  each  name  used  as  input. 
If  the  name  is  not  in  the  user's  data  base,  it  is  added. 

If  so,  a check  is  made  to  see  that  the  context  in  which 
the  name  is  used  in  the  new  input  conflicts  with  the  manner 
In  which  the  name  is  used  in  the  data  base.  If  there  is 
no  conflict,  the  new  relationships  stated  by  the  input 
are  entered  into  the  data  base.  If  there  is  conflict, 
an  error  message  will  be  produced  and  URA  will  skip  to  the 
next  input  statement. 


* The  DELETE  and  DELETE-COMMENT-ENTRY  commands  perform  these  functions. 
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COMPLETE  USER  REQUIREMENTS  REFERENCE 


This  report  provides  a complete  statement  of  all  the  data  in  the 
URA  data  base  in  syntactically  correct  URL  but  formatted  for  ease 
of  reading.  This  report  is  not  simply  a listing  of  all  statements 
that  have  been  entered  into  the  data  base  since  all  the  informa- 
tion provided  by  complementary  statements  is  included.  Further- 
more, the  order  is  different.  This  report  is  intended  as  a 
basic  reference  of  the  current  state  of  definition  of  the  problem 
as  it  provides  all  cross  references. 


8.1  FORMATTED  PROBLEM  STATEMENT 


4 

i 


Purpose:  This  output  aids  the  analyst  in  specifying  a complete 

system  description  by  generating,  for  any  object(s) 
used  as  input  to  the  command,  all  information  currently 
in  the  URA  data  base  about  the  object(s).  The  analyst 
can  then  determine  whether  the  information  is  incomplete 
In  describing  that  object  or  presently  invalid.  In 
this  sense,  the  output  is  an  aid  to  the  analyst. 

Depending  on  the  particular  organization's  requirements 
for  final  system  specifications,  this  output  can  make 
up  a large  portion  of  these  specifications.  Since  it 
presents  all  the  information  for  any  given  name,  the 
cross  referencing  problem  in  manual  methods  of  documen- 
tation is  avoided. 

Command:  This  output  is  generated  any  time  the  URA  command, 

FORMATTED- PROBLEM-STATEMENT,  is  given  with  the  PRINT 
parameter  in  effect. 

Options:  The  format  of  this  output  can  be  varied  tremendously  by 

reassignment  of  the  format  parameters:* 

AMARG 

BMARG 

CMARG 

HMARG 

NEW-LINES 

NEW-PAGE 

NMARG 

SEVERAL-PER-PAGE 

RNMARG 

SMARG 

Some  information  in  the  FPS  (FORMATTED-PROBLEM- STATEMENT) 
can  be  omitted  when  using  the  NOCOMMENT,  NODEFINE  and 
NODESG  parameters. 

An  index  into  the  FPS  will  be  produced  if  the  INDEX 
parameter  is  specified.  This  aids  in  locating  names 
In  the  FPS  output  when  the  output  generated  is  fairly 
large. 

Contents  and  Order:  The  output  for  the  FPS  is  in  the  same  order 
as  the  names  used  as  input  are  read  by  the  command. 

All  the  information  stored  in  the  data  base  about  that 
name  is  printed  out  in  the  form  of  proper  URL  statements 
immediately  following  the  name.  These  URL  statements 


* See  Part  II  1 i for  a detailed  explanation  of 

these  parameters. 


are  also  ordered,  but  according  to  what  information 
they  give  about  the  particular  name.  In  general,  these 
statements  are  ordered  in  the  following  manner. 
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\ 
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Analysis: 


Identification  and  Description  statements 

Structure  statements 

Flow  statements 

Size  and  Volume  statements 

Dynamic  information  statements 

Miscellaneous  statements 

The  Identification  and  Description  statements  are 
statements  that  are  common  to  all  different  names  such 
as: 

SYNONYMS 

DESCRIPTION 

SEE-MEMO  4 

KEYWORDS 

ATTRIBUTES 

The  Structure  statements  are  those  which  specify 
hierarchical  and  network  relationships  such  as  SUBPARTS, 
CONSISTS,  SUBSETS,  UTILIZES,  etc. 

The  Flow  statements  are  those  which  relate  data  and 
processes  such  as  RECEIVES,  USES,  DERIVED,  etc. 

The  Size  and  Volume  statements  correspond  to  CARDINALITY 
and  VALUES  statements,  etc. 

The  Dynamic  information  statements  relates  the  status 
of  objects  over  time.  Examples  of  this  are  the 
VOLATILITY  and  HAPPENS  statements. 

Miscellaneous  statements  are  those  contained  for  the 
purpose  of  project  management.  They  are: 

RESPONSIBLE-PROBLEM-DEFINER 

SECURITY 

SOURCE 

This  report  basically  just  takes  information  from  the 
data  base  and  formats  it.  A check  is  made  that  the  names 
used  as  input  are  actually  in  the  data  base. 
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DIRECTORIES,  DICTIONARY,  GLOSSARIES  and  KWIC  INDEX 


The  directories  generated  in  URA  are  lists  of  names.  They  may 
list  all  the  names  in  the  data  base  or  can  be  very  selective  and 
only  generate  those  names  that  satisfy  particular  criteria  such 
as  being  PROCESS  names  with  a particular  KEYWORD  associated  with 
them.  The  outputs  have  multiple  functions  as  they  can  also  be 
used  to  aid  in  the  production  of  other  outputs.  For  example,  if 
a list  of  all  PROCESSES  were  generated  and  these  names  put  into  a 
file,  then  the  contents  of  this  file  could  be  used  as  input  to 
another  report  command,  such  as  PICTURE,  to  generate  PICTURE  outputs 
for  all  PROCESSES.  Of  course,  these  directories  aid  the  analyst 
in  keeping  track  of  names  used  in  the  user  requirements  and  can 
also  be  used  as  directories  for  the  final  specifications. 

The  dictionary  offers  summary  information  about  the  names  in  it 
and  in  particular,  information  pertaining  to  the  identification 
and  narrative  description  of  these  names.  The  dictionary  proves 
to  be  an  aid  in  maintaining  consistency  in  the  user  requirements 
by  presenting  information  about  names  which  can  then  be  compared 
for  similarity  and  to  avoid  redundancy.  The  dictionary  could  also 
become  part  of  the  final  specifications  whenever  a reference  guide 
to  names  in  the  specifications  is  desirable. 

The  glossaries  provide  summary  information  also,  but  only  in 
narrative  format.  The  glossaries  can  serve  much  of  the  same  purpose 
as  the  dictionary  except  that  the  glossary  is  usually  a reference 
into  the  final  specifications,  whereas  the  dictionary  can  be  complete 
within  itself. 


Purpose:  This  report  can  be  used  in  several  ways.  It  can  be 

used  by  the  analyst  in  defining  names  (avoiding 
redundancy)  to  be  put  in  the  data  base.  It  can  be 
used  as  part  of  the  final  specifications  to  serve  as 
summary  information  to  the  rest  of  the  documentation. 

It  can  also  be  used  as  a stand-alone  document  after 
the  system  is  completed  to  aid  in  defining  new  objects 
entered  into  the  system.  This  report  provides  a means 
of  communication  between  user  and  analyst  to  assure 
that  requirements  are  being  met  and  definitions  are 
accurate. 

Command:  The  basic  report  is  automatically  generated  when  the 

DICTIONARY  command  is  specified. 

Options:  Certain  information  can  be  omitted  in  the  dictionary 

by  specifying  any  of  tne  parameters: 

NODESCRIPTION 

NOKEYWORDS 

NORESPONSIBLE-PD 

NOSYNONYMS 

If  all  these  parameters  were  specified,  it  would  only 
produce  the  same  information  available  in  the  NAME  GEN 
output.  Giving  these  optional  parameters  allows  the 
user  to  be  more  selective  in  choosing  the  contents  of 
the  DICTIONARY  REPORT. 

The  formatting  of  the  report  can  be  altered  somewhat 
by  varying  NUM-SPACE,  which  specifies  the  numoer  of  lines 
between  the  dictionary  entries. 

An  index  is  available  into  this  report  when  specifying 
the  INDEX  parameter.  This  is  beneficial  when  the  dictionary 
i s 1 arge . 

Contents  and  Order:  As  pointed  out  previously,  the  contents  can 

vary  depending  on  which  parameters  are  specified. 

Assuming  that  all  defaults  are  in  effect,  for  each  name 
used  as  input  to  this  command,  the  name  and  its  correspond- 
ing name  type  are  printed  out  along  with  any  information 
contained  in  the  DESCRIPTION,  KEYWORDS,  RESP0NSI3LE- 
PROBLEM-DEFINER,  and  SYNONYMS  statements  associated  with 
that  name.  The  dictionary  entries  are  ordered  in  the 
same  way  as  the  list  of  names  used  as  input  to  the 
DICTIONARY  command. 
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9.2  URA  KWIC  INDEX 


Purpose:  The  KWIC  INDEX  is  a tool  for  the  analyst  in  finding 

names  used  in  the  data  base  which  are  logically  related 
by  the  keywords  within  those  names.  The  two  names 
W-2-TAX-F0RM  and  FAX-FORM  would  be  related  by  their 
common  use  of  the  keyword,  TAX,  and  again  by  the  word, 
FORM.  Upon  this  discovery  the  analyst  may  find  that 
both  names  are  being  used  for  the  same  object  (perhaps 
an  Inconsistency)  or  that  they  are  indeed  different 
tax  forms  and  should  be  better  specified  (an  ambiguity). 

Command:  The  output  is  generated  whenever  the  KWIC  command  Is 

given. 

Options:  A slight  modification  of  the  output  format  is  possible 

through  the  use  of  the  DIF  parameter.  It  specifies  the 
number  of  spaces  between  the  keyword  in  the  name  and 
the  rest  of  the  name. 

Contents  and  Order:  Every  word  in  front  of,  or  following  a "dash" 

in  a URL  name  is  treated  as  a keyword  by  the  KWIC 
command.  All  the  names  used  as  input  to  this  command 
are  permuted  about  the  "dashes"  in  the  names.  Then, 
all  names  and  permuted  names  are  sorted  and  printed  on 
the  output,  in  alphabetical  order.  The  name,  RAD-INPUT- 
DATA,  would  have  three  listings  in  the  KWIC  output. 

The  first  one  would  be  the  whole  name: 

BAD- INPUT-DATA 

The  next  would  be: 

OATA  BAD-INPUT 

and  the  last: 

INPUT-DATA  BAD 

Analysis:  Aside  from  the  program  needed  to  perform  the  permuting 

task  on  the  names, the  output  is  basically  produced 
through  rearrangement  and  formatting  of  the  names  used 
as  input  to  the  KWI(J  command. 
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9.3  NAME  GEN 


Purpose:  This  output  is  produced  by  the  most  powerful  command 

In  the  UR A system. 

1.  It  Is  an  important  aid  to  the  analyst  in  obtaining 
other  reports  and  outputs.  For  example,  the 
analyst  can  ask  for  a list  of  all  SET,  ENTITY  and 
GROUP  names  and  with  this  list  then  ask  for  a 
CONTENTS  REPORT  for  those  names. 

2.  It  is  also  used  by  the  analyst  as  a reference  to 
what  names  have  been  used  and  how  they  have  been 
used  (i.e.,  if  it  is  a SET  rather  than  an  INPUT 
name) . 

3.  The  output  can  also  be  used  effectively  by  project 
management  to  measure  productivity  of  the  project 
members.  This  can  be  done  by  retrieving  a list  of 
all  names  In  the  URA  defined  by  a particular 

user  (analyst)  and  comparing  it  to  previous  lists. 


4.  Finally,  the  NAME  GEN  output  can  become  an  integral 
part  of  the  final  specifications  as  it  acts  as  a 
directory  in  specifying  name  lists  corresponding  to 
certain  selection  criteria  (a  directory  of  all 
data  elements  may  be  desired  before  a section  wnich 
deals  with  the  definition  of  each  element  in  detail). 

Command:  Though  this  output  can  be  varied  in  so  many  ways,  the 

most  basic  form  of  this  output  can  be  the  TOTAL  parameter. 
This  produces  a list  of  all  names  in  the  users  URA  cata 
base  including  undefined  names  and  synonyms. 

Options:  The  parameters  available  in  the  conmand  allows  the  user 

to  be  very  selective  in  which  names  he  chooses  to  retrieve 
from  the  data  base.  The  user  may  only  choose  those  names 
which  are  of  a particular  name-type  (say  GROUP  name 
types)  by  specifying  the  GROUP  parameter.  Only  GROUP 
names  will  be  produced  on  the  output  (assuming  no  other 
parameters  are  given).  To  get  all  the  names  associated 
with  more  than  one  name  type  the  user  only  need 
specify  the  parameter  that  corresponds  to  eacn  of  the 
name  types  the  user  requests.  In  other  words,  to  get  a 
list  of  all  SETS,  ENTITIES  and  GROUPS  the  appropriate 
conmand  would  be: 

NAME- GEN.  SET  ENTITY  GROUP 

A list  of  all  names  except  synonyms  and  undefined  names 
can  be  obtained  by  specifying  the  ALL  parameter. 
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Other  parameters  offer  even  more  specific  selection 
criteria.  To  get  a list  of  all  names  defined  by 
J-SMITH  the  command  would  be: 

NAME-GEN  ALL  PD=J -SMITH 

To  get  all  PROCESSES  that  had  the  KEYWORD  BATCH 
associated  with  them,  we  could  specify: 

NAME-GEN  PROCESS  KEY*=BATCH 

The  ordering  of  the  output  may  be  changed  somewhat 
through  the  use  of  the  ORDER  parameter.  With  0RDER= 
ALPHA,  the  output  is  produced  with  all  names  in  the 
output  In  alphabetical  order.  With  ORDER=BYTY?E  in 
effect,  all  names  are  ordered  first  by  their  correspond- 
ing name  type  (i.e.,  ATTRIBUTE  through  UNDEFINED)  and 
then  alphabetically  by  name  within  name  type. 

I have  presented  but  a few  nnt.lnns  for  the  NAME  GEN 
output.  See  Part  II  for  the  otner 

parameters  available  with  this  command. 

Contents  and  Order:  The  contents  of  the  output  vary  according  to 
what  parameters  have  been  specified.  The  general  format 
Is  that  of  a list  of  names  which  are  contained  in  the 
data  base  with  the  name  type  associated  with  each  name, 
on  the  same  line,  on  the  right  hand  side  of  the  output. 
Again,  the  ordering  of  the  outout  depends  on  how  ORDER 
was  assigned.  Appropriate  messages  are  generated  wnen 
no  names  fit  the  selection  criteria. 

Analysis:  The  command  must  check  each  name  in  the  data  base  to 

see  If  they  fit  the  selection  criteria  specified  by 
the  parameters.  For  each  name  that  it  does,  it  is  a 
simple  matter  of  retrieval  and  formatting. 
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Purpose: 


To  be  used  as  a directory  facility  by  anyone  needing 
a reference  to  all  names  in  the  user's  data  base. 


Command:  The  output  is  generated  through  use  of  the  NAME-LIST 

comnand. 

Options:  The  only  option  available  is  the  order  in  which  names 

appear- either  alphabetical  or  alphabetical  within 
type. y 

Contents  The  output  is  an  alphabetical  listing  of  all  names 

and  Order:  in  the  users  data  uase  with  eacn  name's  corresponding 

name  type  followed  by  synonyms ,if  any.  If  there  is 
more  than  one  synonym,  each  appears  on  a separate 
line  below  the  previous  one. 

Analysis:  It  is  a simple  retrieve  and  format  procedure  to 

obtain  this  output. 
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9.5  PUNCHED  COMMENT  ENTRIES 

Purpose:  Technically,  this  output  serves  as  report  presenting 

narrative  Information  in  the  manner  of  a glossary. 

Its  main  objective,  however,  is  to  act  as  an  aid  to 
the  analyst  in  changing  comment  entries  in  conjunction 
with  the  REPLACE-COMMENT-ENTRY  command.  The  idea  of 
using  the  output  as  a glossary  (for  final  specifications 
perhaps)  should  not  be  overlooked,  however. 

Command:  The  production  of  this  output  is  Initiated  through  the 

PUNCH-CCMMENT-ENTRY  command  with  the  PRINT  parameter  in 
effect.  Other  parameters  must  be  given  in  order  to 
specify  what  comment  entries  are  to  be  printed. 

Options:  Any  reasonable  combination  of  the  different  types  of 

comment  entries  can  be  specified,  as  parameters  for 
the  output.  Care  should  be  taken  to  assume  that  the 
choice  of  parameters  is  consistent  with  the  types  of 
names  for  which  the  output  will  be  generated  (one  would 
not  try  to  get  the  PROCEDURE  comment  entries  associated 
with  a list  of  SET  names). 

Contents  and  Order:  For  each  name  used  as  input  to  the  command,  the 

name  is  printed  on  the  output  in  the  order  in  which  it 
was  read  (FIFO)  and  associated  with  that  name  the  type 
of  comment  entry  and  the  text  for  that  comment  entry 
— (for  each  type  of  comment  entry  as  specified  in  the 

parameter  list). 

Analysis:  This  is  basically  a retrieval  and  format  procedure.  A 

message  Is  given  when  no  comment  entry  is  available  for 
a particular  comment  entry  type  or  the  name  specified 
is  not  in  the  data  base. 
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10.  STRUCTURE  OUTPUTS 

The  structure  reports  describe  the  relationships  between  target 
system  objects  as  specified  by  the  structure  statements  of  URL 
which  are  summarized  in  Table  10. a.  The  URL  statements  only 
specify  one  level  of  structure,  such  as  A is  a SUBPART  of  B, 
where  the  report  has  the  ability  to  present  all  levels  of  structure 
(l.e.,  A is  a SUBPART  of  B,  which  is  a SUBPART  of  C,  etc.). 

Classification  of  Structure  Report 

The  format  of  the  structure  report  and  the  analysis  performed 
to  obtain  it  depend  on  several  structure  characteristics: 

Class  of  Structure 
Type  of  Structure 
Structure  Report  Content 

Class  of  Structure 

There  exists  basically  three  classes  of  structure  in  describing 
IPS  structures: 

1.  Real  World  Structures:  those  structures  which  exist  in  the 

organization  for  which  the  IPS  is  to  serve.  The  relationships 
between  departments  and  personnel  (designated  by  REAL-WORLD- 
ENTITIES)  would  be  defined  in  terms  of  the  "real"  or  actual 
structure  that  exists  in  the  organization. 

2.  Logical  Structures:  those  structures,  as  specified  by  the 

analyst,  to  be  used  as  an  aid  in  communicating  between  logical 
and  physical  system  designers  the  relationships  that  exist 
between  data  in  the  system.  By  specifying  logical  relationships 
between  SETS,  ENTITIES,  and  ELEMENTS  at  an  early  stage,  it  is 
easier  to  design  and  implement  a physical  system  with  correspond- 
ing files,  records  and  data  elements. 

3.  Definitional  Structures:  those  structures  defined  by  the 

user  to  be  used  as  an  aid  in  the  system  design 
process.  For  example,  by  structuring  PROCESSES  into 
subsequent  sub-levels  it  would  be  easy  to  facilitate  the 
"top-down"  approach  in  designing  the  system. 

Type  of  Structure 

Structures  may  be  classified  as  tree  structures  (Figure  10. a)  or 
as  acyclic  networks  (Figure  lO.b).  The  difference  is  that  in  a 
tree  structure  any  given  node  may  be  related  to  only  one  higher 
level  node  while  acyclic  networks  allow  relationships  to  exist 
with  several  higher  level  nodes. 


e level  structure  relationships  as  specified  by 
!L  statements.  To  be  read  from  row  to  column. 


* 

i 


Figure  10. a Tree  Structure 


Figure  lO.b  Acyclic  Network 


Structure  Report  Content 


There  are  several  objects  for  which  structural  relationships  can 
be  defined.  Each  particular  type  of  object  can  be  related  to  a 
particular  class  of  structure  as  shown  by  Table  10. b. 


Table  10. b 


objects 

statements 

class  of  structure 

REAL-WORLD-ENTITY 

SUBPARTS/PART 

Real  World 

PROCESS 

SUBPARTS/PART 

Definitional 

INPUT/OUTPUT 

SUBPARTS/PART 

Definitional 

INPUT/OUTPUT 

CONTAINED 

Defini tional 

INPUT/OUTPUT 

CONSISTS 

Logical 

INTERVAL 

CONTAINED/SETS 

Logical 

SET 

CONSISTS 

Logical 

SET 

SUBSETS/SUBSET 

Logi cal 

ENTITY 

CONTAINED/CONSISTS 

Logical 

GROUP 

CONTAINED/CONSISTS 

Logical 

ELEMENT 

CONTAINED 

Logical 
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The  type  of  structure  statements  presented  by  the  report  determines 
what  type  of  structure  is  present.  This  relationship  between  URL 
statements  and  type  of  structure  is  given  in  Table  10. c. 


Table  10. c 


Structure  Statements 

Type  of  Structure 

SUBPARTS/PART 

Tree 

SUBSETS/SUBSET 

Acyclic  Network 

CONSISTS/CONTAINED 

Acyclic  Network 

10.1  CONTENTS  REPORT 


Purpose:  This  report  is  intended  as  an  aid  to  the  analyst  in 

communicating  with  others  on  the  logical  structure 
relationships  among  data  items  in  the  users  data  base. 

This  report  presents  the  network  structure  correspond- 
ing to  the  CONSISTS  statements  associated  with  SETS, 
ENTITIES,  GROUPS,  INPUT  and  OUTPUTS  in  the  target 
system  description.  This  report  gives  the  analyst  the 
ability  to  look  at  all  levels  of  the  structure  at  one 
time.  This  report  is  very  beneficial  at  the  time 
when  some  data  structure  must  be  devised.  This  report 
provides  some  of  the  guidelines  for  doing  so. 

Command:  This  report  is  generated  whenever  the  CONTENTS  command 

is  Issued. 

Options:  The  report  can  be  generated  for  one  or  several  names. 

The  user  can  also  be  selective  in  choosing  the  number 
of  levels  to  be  presented  in  the  structure  by  assigning 
, the  parameter,  LEVELS,  with  a particular  value.  An 
index  into  the  report  can  also  be  produced  when  the 
INDEX  parameter  is  given.  Information  concerning  the 
incompleteness  of  the  structure  can  be  produced  when 
the  NCFLAG  parameter  is  in  effect.  It  flags  all  those 
GROUPS  used  in  the  report  that  have  not  been  defined 
to  consist  of  any  subordinate  GROUPS  and/or  ELEMENTS. 

NCFLAG  also  flags  UNDEFINED  names  contained  in  GROUPS, 
INPUTS,  OUTPUTS,  ENTITIES  or  SETS. 

Contents  and  Order:  Each  name  used  as  input  to  the  command  is 

specified  as  being  a level  1 object.  This  name  is 
printed  along  with  its  corresponding  name  type  next  to 
it  in  parentheses.  All  the  objects  this  name  CONSISTS 
of  are  specified  as  level  2 objects  and  printed  along 
with  their  name  type.  These  level  2 objects  then  have 
the  objects  they  consist  of  printed  as  level  3 objects, 
etc.  Any  system  parameter  associated  with  these 
CONSISTS  statements  are  also  included  in  the  output. 

This  procedure  Is  continued  to  the  level  which  have  only 
ELEMENT  names.  This  is  the  lowest  level. 

Analysis:  An  algorithm  is  used  to  traverse  the  paths  in  the  structure 

and  to  specify  which  objects  belong  to  which  levels.  This 
makes  it  more  complicated  than  a simple  retrieval  procedure 
As  this  information  is  retrieved  it  must  also  be  formatted 
in  an  appropriate  manner. 

I 
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10.2  PICTURE 


Purpose:  To  present  flow  and  structure  Information  in  a graphical 

format.  For  any  given  object  this  output  presents  its 
structure  by  specifying  only  those  objects  which  are  in 
the  level  directly  above  it  and  those  objects  in  the 
level  directly  below  it  (this  is  the  same  structure  infor- 
mation that  is  presented  in  the  FPS).  This  output  is  a 
valuable  tool  to  the  analyst  for  conmuni  eating  with  other 
people  as  it  is  in  a format  illustrative  of  the  relation- 
ships specified  for  the  given  object  (i.e.,  ail  flow 
Information  goes  from  left  to  right  and  structure  informa- 
tion from  top  to  bottom).  (Also  described  in  Section  11.1 
on  how  It  relates  to  flow.) 

Command:  Structure  Information  Is  presented  when  the  PICTURE  command 

is  used  in  conjunction  with  the  STRUCTURE  parameter.  Names 
used  as  Input  to  this  command  must  be  RWE,  PROCESS,  INPUT, 
OUTPUT,  SET,  ENTITY,  GROUP  or  ELEMENT  names. 

Options:  Flow  information  is  optional  in  the  output  and  may  be 

omitted  by  specifying  NODATA  and  N0FL0W.  When  the  OUTPUT 
Is  fairly  large  It  may  be  advantageous  to  specify  the 
INDEX  parameter  to  generate  an  index  into  the  output. 

Contents  and  Order:  The  object  being  described  is  contained  within 
a printed  box  centered  in  the  middle  of  the  page.  All 
objects  related  to  the  central  object  are  also  contained 
within  boxes  arranged  around  the  perimeter  of  the  page. 

The  top  line  of  each  box  specifies  what  type  of  ODject  it 
is  (i.e.,  PROCESS,  ELEMENT,  etc.).  The  bottom  line  of  the 
boxes  specifies  what  relationship  the  object  within  the 
box  has  with  the  central  object.  For  illustrative  purposes, 
lines  extend  from  each  box  to- the  central  object.  The 
boxes  relating  to  the  central  base  are  formatted:  five 

above,  five  below  and  six  on  the  right  or  left.  These  are 
maximum  allowed  to  fit  on  a given  page.  Any  overflow  is 
continued  on  successive  pages. 

Analysis:  The  PICTURE  REPORT  involves  a simple  retrieval  procedure 

similar  to  that  in  the  FPS.  The  main  difference  is  the 
manner  of  presentation.  Many  more  formatting  problems 
are  encountered  when  implementing  graphical  rather  than 
narrative  descriptions  for  objects. 


NOTE:  The  structure  of  PICTURE  reports  is  shown  on  page  81a  and  the 

contents  of  PICTURE  reports  for  each  type  of  object  are  shown 
on  pages  81b-81h. 
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10.3  STRUCTURE 

_ Purpose:  This  output  is  Intended  as  an  aid  in  presenting  those 

structures  defined  by  the  analyst  for  ease  of  problem 
specification  and  Real  World  Structures.  This  output 
presents  the  structure  in  a form  that  the  analyst  can  use 
In  his  own  work  and  for  communicating  with  users  and  system 
designers.  It  presents  the  tree  structure  corresponding 
to  the  SUBPARTS  statement  associated  with  REAL-WORLD- 
ENTITIES,  INPUTS,  OUTPUTS  and  PROCESSES.  The  output 
gives  the  user  the  ability  to  look  at  all  levels  of  a 
particular  tree  in  an  easy-to-read  format. 

Command:  The  output  Is  generated  whenever  the  STRUCTURE  command 

Is  given. 

Options:  For  each  production  of  the  output,  only  one  type  of 

object  (INPUT,  OUTPUT,  PROCESS  or  RWE)  may  be  used  as 
Input  to  the  command  hence,  one  of  these  types  must  be 
specified  as  a parameter.  An  Index  to  the  output  can  also 
be  produced  by  specifying  INDEX  as  one  of  the  parameters. 

The  format  of  the  output  can  be  modified  somewhat  by 
specifying  a value  for  IDENT.  This  parameter  specifies 
the  number  of  spaces  to  indent  each  new  level  of  the 
structure. 

Contents  and  Order:  For  any  given  type  of  object  that  the  STRUCTURE 

output  is  being  generated,  all  names  of  that  type  are 
contained  in  the  output.  These  names  which  are  not  a 
SUBPART  to  any  other  name  are  specified  as  level  1 
names.  Those  names  which  are  SUBPARTS  to  this  name  are 
level  2,  etc.  After  all  this  structure  Information  has 
been  presented  a summary  section  is  printed  to  give  certain 
statistics  about  the  output.  For  each  level  of  the  structure 
a count  Is  given  of  the  total  number  of  names  In  that  level. 

Analysis:  An  algorithm  to  traverse  the  tree  structure  must  be  used  to 
print  the  structure.  Also,  some  simple  analysis  must  be 
provided  to  check  for  looping  structures.  When  a loop  is 
encountered  an  error  message  is  generated.  The  formatting 
procedure  for  the  output  varies  level  by  level  and  involves 
more  than  a simple  retrieval  and  format  process. 

• . 
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10.4  CONSISTS  MATRIX 

Presents  the  information  available  by  the  CONTENTS  REPORT 
but  in  a more  analyzable  format.  Through  the  use  of  a 
matrix  this  output  proves  valuable  in  illustrating 
relationships  between  objects  which  may  not  be  apparent 
when  looking  at  the  CONTENTS  REPORT.  For  example, 
through  matrix  representation  of  structure  it  is  easy 
to  see  when  two  or  more  objects  may  consist  of  the  same 
or  very  similar  information.  This  can  then  be  used  to 
improve  the  logical  description  as  well  as  an  aid  when 
designing  the  physical  system.  This  output  is  intended 
as  an  aid  primarily  to  analyst  and  physical  system  designers. 

This  output  is  generated  whenever  the  CONSISTS  MATRIX 
command  is  given  in  conjunction  with  either  the  CONSISTS 
or  CONTAINED  parameter. 

When  the  CONTAINED  parameter  is  used,  all  the  names  used 
as  input  to  the  command  are  designated  a number  to  represent 
one  of  the  columns  in  the  matrix.  All  the  objects  that 
are  CONTAINED  in  the  input  names  are  designated  numbers 
corresponding  to  a particular  matrix  row.  A CONTAINED 
relationship  between  column  and  row  is  specified  by  an 
asterisk  (*).  When  the  CONSISTS  parameter  is  used,  all 
the  names  used  as  input  to  the  command  are  designated  a 
number  to  represent  a particular  row  in  the  matrix.  All 
the  objects  that  CONSIST  of  these  input  names  are  designated 
numbers  corresponding  to  a particular  column.  A CONSISTS 
relationships  between  row  and  column  is  specified  by  an 
asterisk  (*). 

Contents  and  Order:  The  first  part  of  the  output  signifies  which 

names  have  no  relationships  specified  in  the  matrix.  Then 
a listing  is  presented  to  show  correspondence  of  a 
particular  name  to  its  row  number  and/or  column  number  in 
the  matrix.  The  assignment  of  numbers  is  dependent  on 
the  order  read  in  by  the  command.  Next  comes  the  matrix 
Itself  with  asterisks  designating  the  CONSISTS/CONTAINED 
relationships  between  row  numbers  and  column  numbers. 

Objects  represented  by  rows  are  CONTAINED  in  the  objects 
represented  by  the  columns.  A blank  row  designates  that 
the  object  represented  by  the  row  is  not  CONTAINED  by  any 
other  object.  A blank  column  designates  that  the  object 
represented  by  the  column  does  not  CONSIST  of  any  objects. 
Finally,  summary  information  is  printed  to  present  some 
statistics  on  the  matrix  information.  This  summary 
presents,  for  each  name  represented  by  a row,  the  number 
of  columns  to  which  it  is  related  (the  number  of  objects 
that  CONTAIN  It)  and,  for  each  name  represented  by  a 
column,  the  number  of  objects  it  CONSISTS  OF. 
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Purpose: 


Command: 


Options: 


. 


■- 
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Analysis: 


A check  is  done  to  see  which  names  used  as  input  have  nc 
relationships  specified  in  the  matrix.  An  algorithm  for 
presenting  data  base  information  in  a matrix  format  must 
be  read  and  statistical  information  must  be  extracted  for 
presentation  in  the  summary  section  of  the  output. 
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10.4a  CONSISTS  COMPARISON  REPORT 


Purpose:  Derives  information  available  from  the  CONSISTS  statements. 

For  each  input  object,  its  lowest  level  constituents  (the 
bottom  nodes  of  the  CONSISTS  network  structure)  are  retrieved. 
A matrix  illustrates  the  relationships  >etween  input  names 
and  lowest  level  constituents.  From  this,  the 
user  can  determine  the  degree  of  similarity  between  data 
(number  of  low  level  constituents  in  comnon  between  any 
two  data  objects)  and  redundancy  (two  objects  which  con- 
sist of  the  same  low  level  constituents).  This  is  intended 
as  an  aid  to  the  analyst  to  improve  the  quality  of  the 
problem  statement. 

Conmand:  This  report  is  generated  whenever  the  CONSISTS-COMPARISON 

command  is  issued. 

Options:  No  options  are  currently  available  to  change  format  or 

content  of  the  report. 

Contents  and  Order:  The  first  part  of  the  output  specifies  which 

names  have  no  relationships  designated  in  the  matrices. 

Then  a listing  is  presented  to  show  the  correspondence 
of  input  names  to  a particular  row  and  of  derived  low 
level  constituents  to  a particular  column  for  the  BASIC 
CONTENTS  MA.TRIX.  Next  comes  the  matrix  itself  with  an 
asterisk  designating  that  a data  object,  represented  by 
a row,  CONSISTS  (directly  or  indirectly)  of  a low  level 
data  object,  represented  by  a column.  The  CONTENTS 
SIMILARITY  MATRIX  presents  an  analysis  performed  on  the 
first  matrix.  All  the  names  used  as  input  are  represented 
by  a column  number  and  row  number  in  the  matrix.  (The 
numbers  are  the  same  so  that  any  given  object  is  represented 
by  row  J and  column  J.)  The  matrix  should  be  read  from 
row  to  column  as  saying:  the  data  object  represented  by 

row  I has  an  integer  number  of  low  level  constituents  in 
common  with  the  data  object  represented  in  column  J.  Wnen 
I*J,  the  number  of  low  level  constituents  of  any  object 
in  common  with  itself  is  presented.  This  is,  of  course, 
the  total  number  of  constituents  for  that  given  data  object. 
The  final  section  of  this  report  is  the  CONTENTS  SIMILARITY 
ANALYSIS  which  presents  those  input  names  that  have 
identical  lowest  level  constituents  or  which  are  strict 
subsets  (at  the  lowest  level)  of  ocher  input  names. 

Analysis:  A check  is  done  to  see  that  names  used  as  input  have  no 

relationships  specified  in  the  matrices.  Also,  an 
algorithm  must  be  used  to  present  the  data  used  as  input 
and  data  retrieved  into  a matrix  format.  Statistical 
information  is  derived  for  presentation  in  the  second 
matrix.  Finally,  analysis  is  done  for  similarity  of 
the  constituents  for  any  two  or  more  input  names. 
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10.5  IDENTIFIER  INFORMATION  REPORT 

Purpose:  Relates  IDENTIFIER  names  to  the  ENTITIES  that  they 

identify  to  aid  In  improving  the  logical  structure  specified 
by  the  user  requirement  and  also  as  a tool  to  the 
physical  system  designer  in  determining  the  logical  and/or 
physical  data  structures.  A matrix  is  produced  to  illustrate 
these  relationships. 

Command:  This  report  is  generated  through  usage  of  the  ENTITY- 

IDENTIFIER  command  used  in  conjunction  with  either  the 
IDENTIFIER  or  ENTITY  parameter. 

Options:  When  the  IDENTIFIER  parameter  is  used  all  names  used 

as  input  to  the  command  must  be  IDENTIFIER  names.  Each 
of  these  IDENTIFIER  names  corresponds  to  a single  row  of 
the  matrix  and  those  ENTITIES  which  they  identify 
correspond  to  a particular  column  of  the  matrix. 

When  the  ENTITY  parameter  is  used  all  names  used  as  input 
to  the  command  must  be  ENTITY  names.  Each  of  these  ENTITY 
names  corresponds  to  a single  column  of  the  matrix  and 
the  IDENTIFIERS  that  Identify  these  ENTITIES  correspond  to 
a particular  row  number  of  the  matrix. 

Contents  and  Order:  The  first  part  of  the  output  signifies  which 

names  have  no  relationships  specified  in  the  matrix.  Then 
a listing  is  presented  to  show  the  correspondence  of  a 
particular  name  to  its  row  number  or  column  number  in  the 
matrix.  The  assignment  of  numbers  is  dependent  on  the 
order  read  in  by  the  command.  Next  comes  the  matrix  itself 
with  asterisks  designating  the  IDENTIFIES  relationship 
between  row  and  column  numbers.  The  IDENTIFIERS  represented 
by  rows  IDENTIFY  the  ENTITIES  represented  by  the  columns. 

A blank  row  designates  that  the  IDENTIFIER  represented  by 
the  row  does  not  IDENTIFY  any  ENTITIES.  A blank  column 
designates  that  the  ENTITY  represented  by  the  column  is 
not  IDENTIFIED  by  any  IDENTIFIERS.  Finally,  summary 
Information  is  printed  to  present  some  statistics  on  the 
matrix  information.  This  summary  presents,  for  each 
IDENTIFIER  represented  by  a row,  the  number  of  ENTITIES 
It  IDENTIFIES  and,  for  each  ENTITY  represented  by  a 
column  the  number  of  IDENTIFIERS  that  IDENTIFY  It. 

Analysis:  A check  is  done  to  see  which  names  used  as  input  have 

no  relationships  specified  in  the  matrix.  Also,  an 
algorithm  for  presenting  data  base  information  in  a 
matrix  format  must  be  used.  Statistical  information 
must  also  be  extracted  for  presentation  in  the  summary 
section  of  this  output.  J 
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10.6  RELATION  INFORMATION  REPORT 


Purpose:  To  present  Information  about  RELATIONS  to  aid  in  the 

system  description  and  eventually  the  physical  system 
design.  This  output  aids  in  detecting  redundancies, 
incompleteness,  and  inconsistencies  in  the  specification 
of  the  RELATION  information  in  the  user  requirement 
This  output  is  thus  intended  as  a tool  for  the  analyst 
and  the  physical  system  designer. 

Command:  This  output  is  not  currently  available  on  the  URL/URA 

system. 

Contents  and  Order:  Narrative  information  is  intended  to  be  part 

of  the  output  to  function  simply  as  RELATION  definition. 
Three  matrices  provide  more  analyzable  information  about 
the  RELATIONS.  The  first  matrix  describes  the  mapping, 
and  degree  of  mapping  (e.g.,  one  to  many)  between 
ENTITIES.  The  second  matrix  describes  the  interaction 
between  the  RELATIONS  and  corresponding  ENTITIES.  The 
third  matrix  provides  information  about  the  RELATIONS 
and  corresponding  ASSOCIATED  DATA.  Summary  information 
is  provided  to  aid  in  resolving  incompleteness  and/or 
inconsistencies  in  the  RELATION  descriptions.  RELATIONS 
will  be  grouped  based  on  their  utilization,  type  of  usage 
and  parent-child  relationships. 


10.7  INTERVAL  STRUCTURE 


Purpose:  This  output  presents  the  structure  defined  for  time 

intervals  within  the  system  description.  For  definitional 
purposes  it  is  important  to  specify  how  the  organization 
perceives  time.  What  time  intervals  are  relevant,  what 
are  they  called  and  how  they  interact  with  each  other 
are  a few  of  the  questions  to  be  answered  by  this  output. 
This  output  presents  the  information  available  from  the 
CONSISTS  statement  for  INTERVALS. 

Comnand:  This  output  is  not  currently  available  on  the  URL/URA 

system. 

Contents  and  Order:  The  structures  for  INTERVALS  differ  from  those 

for  data  In  the  sense  that  an  INTERVAL  structure,  once 
defined,  remains  static  whereas  the  number  of  occurrences 
In  a data  structure  varies  over  time.  The  output  must 
therefore  take  into  account  the  system  parameters  used 
In  conjunction  with  the  CONSISTS  statements  in  the 
INTERVAL  Section. 
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11.  FLOW  ANALYSIS  OUTPUTS 


Flow  analysis  can  be  {and  has  been)  presented  in  many  different 
formats,  from  narrative  description  to  flow  charting.  Still,  each 
method  of  documenting  this  aspect  of  the  system  description  has 
Its  advantages  and  disadvantages  and  none  of  them  seem  sufficient 
on  their  own.  URA  allows  the  users  to  present  the  system  flow  in 
three  formats: 

Graphical  flow  chart  (PICTURE) 

Matrix  representation  (DATA  PROCESS  REPORT) 

Narrative  description  (PROCESS  INPUT/OUTPUT) 

The  purpose  of  different  formats  is  to  allow  the  same  (or  similar) 
information  to  be  presented  for  different  applications  (i.e.,  for 
communication  between  users  or  as  a tool  for  the  analyst  in  improving 
the  flow  network). 

The  flow  information  is  derived  from  the  RECEIVES,  GENERATES,  USES, 
DERIVES  and  UPDATES  statements  in  URL. 
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11.1  PICTURE 


Purpose:  The  PICTURE  output  allows  the  flow  information  (through 

RECEIVES,  DERIVES,  etc.)  to  be  presented  in  a graphical 
or  flow  chart  format.  This  proves  to  be  a very  easy 
way  to  look  at  the  system  though  it  is  only  possible  to 
see  a small  part  of  the  system  at  any  one  time.  The 
PICTURE  is  very  useful  in  communicating  a view  of  the 
system  to  others.  PICTURES  can  also  play  an  important 
part  in  the  final  specifications  as  it  presents  a 
graphical  summary  of  the  narrative  description  for  any 
given  object.  (The  PICTURE  output  is  also  described  in 
Section  10.2  on  how  it  presents  structure  information.) 

Command:  Flow  information  is  presented  when  the  PICTURE  command 

Is  used  in  conjunction  with  the  FLOW  and  DATA  parameters. 

Names  used  as  input  to  this  command  must  be  RWE,  PROCESS, 
INPUT,  OUTPUT,  SET,  ENTITY,  GROUP  or  ELEMENT  names. 

Options:  Structure  information  is  optional  in  the  output  and  may 

be  omitted  by  specifying  NOSTRUCTURE.  When  the  output 
to  this  command  gets  to  be  fairly  large  it  may  be  advantageous 
to  specify  the  INDEX  parameter  to  generate  an  index  into 
the  output. 

Contents  and  Order:  The  object  being  described  is  contained  within 
a printed  box  centered  in  the  middle  of  the  page.  All 
objects  related  to  the  central  object  are  also  contained 
within  boxes  arranged  around  the  perimeter  of  the  page. 

The  top  line  of  each  box  specifies  what  type  of  object  it 
is  (i.e.,  PROCESS,  ELEMENT,  etc.).  The  oottom  line  of  the 
boxes  specifies  what  relationship  the  object  within  the 
box  has  with  the  central  object.  For  illustrative  purposes, 
lines  extend  from  each  box  to  the  central  object.  The 
boxes  relating  to  the  central  bases  are  formatted:  five 

above,  five  below  and  six  on  the  right  or  left.  These 
are  maximum  allowed  to  fit  on  a given  page.  Any  overflow 
is  continued  on  successive  pages. 

Analysis:  The  PICTURE  REPORT  involves  a simple  retrieval  procedure 

similar  to  that  in  the  FPS.  The  main  difference  is  the 
manner  of  presentation.  More  formatting  problems  are 
encountered  when  implementing  graphical,  rather  than 
narrative,  descriptions  for  objects. 


NOTE: 


The  structure  of  PICTURE  reports  is  shown  on  page  81a  and  the 
contents  of  PICTURE  reports  for  each  type  of  objects  are  shown 
on  pages  81 b-81 h . 
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OUTPUT  PICTURE 


11.2  DATA  PROCESS  REPORT 

Purpose:  To  present  both  data/process  relationships  and  complete- 

ness and  consistency  analysis  for  these  relationships. 

This  information  is  very  valuable  to  the  analyst  for 
Improving  the  system  description  and  aids  in  specifying 
what  Information  is  needed  to  complete  this  description. 

This  report  can  also  be  passed  down  to  physical  system 
designers  to  aid  them  in  their  work  of  improving  the  flow 
of  data  between  processes  and  aids  to  design  data  organi- 
zation. 

Command:  This  report  is  generated  whenever  the  DATA-PROCESS  command 

Is  given  with  either  the  DATA  parameter  or  the  PROCESS 
parameter. 

Options:  If  the  DATA  parameter  is  specified,  the  names  used  as 

input  must  be  INPUT,  OUTPUT,  SET,  ENTITY,  GROUP  or 
ELEMENT  names.  These  names  are  then  assigned  numbers 
corresponding  to  the  rows  of  the  matrix  and  the  PROCESSES 
which  Interact  with  this  data  are  represented  by  the 
columns. 

If  the  PROCESS  parameter  is  specified,  the  names  used  as 
Input  must  be  PROCESS  names.  These  names  are  then  assigned 
numbers  corresponding  to  the  columns  of  the  matrix,  and 
* _ the  data  which  interact  with  these  PROCESSES  are  represented 

1 by  the  columns. 

Any  relationships  between  PROCESS  and  DATA  (column  and  row) 
Is  designated  by  an  "I"  (used  as  input  to  the  process),  a 
"U"  (updated  by  the  PROCESS)  or  “0"  (is  output  from  the 
PROCESS). 

Contents  and  Order:  The  first  part  of  the  report  is  merely  an 

index  into  the  matrix  specifying  the  names  which  represent 
a particular  row  or  column  number.  The  name  types  for 
each  name  are  also  printed.  The  second  part  is  the 
DATA  PROCESS  INTERACTION  MATRIX  which  actually  shows  the 
relationships  between  data  and  PROCESSES  in  matrix  format. 
The  summary  section  for  this  part  is  called  DATA  PROCESS 
INTERACTION  MATRIX  ANALYSIS  and  presents  completeness 
information  concerning  the  names  used  in  the  matrix. 

The  second  matrix  presented  in  this  output  designates 
those  PROCESSES  which  derive  or  update  data  used  by  other 
» PROCESSES.  This  relationship  is  designated  by  an 

asterisk.  The  data  flow  is  from  the  PROCESSES  represented 
by  rows  to  the  PROCESSES  represented  by  columns.  The 
sunmary  for  this  matrix  specifies  those  PROCESSES  which 
have  no  interaction  with  other  PROCESSES,  have  no 
Imnediate  successors,  and  those  with  no  immediate  pre- 
decessors. 
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Analysis:  Aside  from  the  formatting  procedures  (printing  the  name 

lists  and  matrices)  the  most  important  analysis  is  done 
to  produce  the  DATA  PROCESS  INTERACTION  MATRIX  ANALYSIS 
and  the  PROCESS  INTERACTION  MATRIX  ANALYSIS.  For  the 
DATA  PROCESS  INTERACTION  MATRIX  ANALYSIS  the  PROCESS  names 
are  checked  to  see  that  they  interact  with  data,  use  data 
if  data  is  generated  from  the  PROCESS,  etc.  the  data 
In  this  analysis  is  checked  to  ascertain  that  it  is  derived 
by  some  PROCESS,  received  by  some  PROCESS  (if  it  is  an 
INPUT),  etc.  Special  analysis  is  also  done  for  the  PROCESS 
INFORMATION  MATRIX  ANALYSIS.  It  specifies  those  PROCESSES 
which  begin,  end  or  are  not  involved  in  the  flow  of  data 
for  the  system. 
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n.3  PROCESS  INPUT/OUTPUT 

Purpose:  To  present  in  narrative  outline  form  flow  information  for 

PROCESSES.  The  format  of  this  output  is  intended  to  be 
easy  to  read  and  could  be  used  in  communicating  the  des- 
cription of  PROCESS  flow  to  others.  This  output  produces 
the  same  level  of  flow  information  as  given  in  the  PICTURE 
output  (for  PROCESSES). 

Command:  This  output  is  generated  whenever  the  PROCESS- INPUT-OUTPUT 

conmand  is  used. 

Options:  The  PROCESS  DESCRIPTION  can  be  omitted  from  the  output  when 

NODESCRIPTION  is  specified.  Otherwise  the  DESCRIPTION 
comment  entry  associated  with  each  PROCESS  is  printed.  The 
PROCEDURE  comment  entry  associated  with  each  PROCESS  can  be 
included  as  part  of  the  description  when  the  PROCEDURE 
parameter  is  specified.  The  user  can  be  selective  in 
choosing  to  have  either  data  used  as  input  or  data  used  as 
output,  or  both,  included  in  the  printout.  When  the  report 
may  be  fairly  large,  it  is  advantageous  to  specify  the 
INDEX  parameter  to  generate  an  index  into  the  report. 

Contents  and  Order:  For  each  PROCESS  name  used  as  input  to  the 

command,  the  DESCRIPTION  comment-entry  for  that  name  is 
printed  out.  Along  with  this  is  all  the  information 
corresponding  to  the  USES,  UPDATES,  RECEIVES,  GENERATES, 
and  DERIVES  statement  associated  to  that  PROCESS.  The 
data  names  in  these  statements  are  classified  as  either 
INPUTS  or  OUTPUTS  to  the  PROCESS  and  formatted  as  such. 

Analysis:  Production  of  this  output  basically  involves  a retrieval 

operation  to  obtain  all  data  needed.  A check  is  made 
and  a comment  printed  for  PROCESSES  which  do  not  have  any 
Inputs  or  outputs. 
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DYNAMIC  ANALYSIS  OUTPUTS 


These  outputs  intend  to  present  the  state  of  the  system  over  time. 
Where  the  previous  sections  describe  outputs  which  only  give  a 
static  representation  of  the  system,  these  outputs  give  a dynamic 
representation. 

More  specifically,  they  present  information  associated  with  the 
EVENTS  and  INTERVALS  used  in  the  system  description. 


Purpose:  To  present  frequency  information  pertaining  to  events. 


occurrence  of  inputs,  occurrence  of  outputs  and  processing. 
All  information  associated  with  the  HAPPENS  statement  is 
presented  by  this  report.  This  information  will  be  needed 
in  later  stages  of  the  design  process  when  estimating 
workloads  and  specifying  physical  characteristics  of  the 
system.  It  can  be  used  by  the  user  to  check 
for  completeness  of  such  information  over  the  whole  system 
and  to  check  for  accuracy  of  the  current  information. 

Command:  The  report  is  initiated  whenever  the  FREQUENCY  command  is 

given. 

Options:  At  present,  no  variations  in  the  report  are  available. 

Contents  and  Order:  Each  INTERVAL  name  in  the  data  base  which  has 

a HAPPENS  statement  related  to  it  is  printed  out.  Each 
object  related  t"  tb is  INTERVAL  via  the  HAPPENS  statement 
is  then  printed  ouc  v its  corresponding  name  type 
(either  EVENT,  INPUT,  -JTPUT  or  PROCESS)  and  the  system 
parameter  which  specif’,  the  number  of  times  this  object 
occurs  in  the  INTERVAL.  . ie  INTERVALS  are  ordered  alpha- 
betically. 

. 

Analysis:  Production  of  this  report  mainly  involves  a retrieval 

, — process  to  extract  the  information  relating  to  the  HAPPENS 

statement. 
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Purpose:  To  present  information  relating  EVENTS  and  CONDITIONS 

used  in  the  user  requirement.  Such  information  is 
normally  captured  by  a truth  table.  This  output  gives 
the  user  the  ability  to  check  for  completeness 
In  dealing  with  CONDITIONS  and  accuracy  in  defining  the 
resulting  EVENTS  given  a value  for  a CONDITION. 

Command:  At  present  this  output  is  not  available  on  the  URL/URA 

system. 

Contents  and  Order:  This  output  will  probably  present  the  informa- 

tion available  by  the  BECOMING  statements  for  CONDITIONS 
which  can  readily  be  presented  in  matrix  or  truth  table 
format.  A.  summary  will  probably  be  given  to  aid  in 
resolving  redundancies  and/or  incompleteness. 
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12.3  DYNAMIC  ANALYSIS  REPORT 

™ ¥ 

Purpose:  This  report  is  intended  to  present  complex  relationships 

among  EVENTS,  INTERVALS  and  PROCESSES  (perhaps  INPUTS 
and  OUTPUTS  will  eventually  be  included).  The  main 
objective  is  to  show  the  dependency  between  PROCESSES 
and  EVENTS  in  order  to  derive  a sequencing  order  of  when 
PROCESSES  occur.  This  report  will  also  present  information 
concerning  consistency  of  frequency  of  EVENTS  related  to 
frequency  of  PROCESSES.  For  example,  either  EVENT  El  or 
E2  TRIGGERS  PROCESS  PI,  the  frequency  associated  to  PI 
should  be  equal  to  the  sum  of  frequencies  El  and  E2.  When 
this  is  not  the  case  some  explanation  shpuld  be  specified. 
This  report  is  intended  as  an  aid  to  the  analyst  in 
detecting  Incompleteness  and  inconsistencies  in  the  user 
requirement  related  to  dynamic  analysis.  This  report 
can  be  included  as  part  of  the  final  specifications. 

Command:  At  present,  this  report  has  not  been  implemented  on  the 

URL/URA  system. 

Contents  and  Order:  A matrix  will  probably  be  used  to  relate  PROCESSES 

and  EVENTS.  EVENTS  will  be  represented  by  the  columns  of 
the  matrix  and  PROCESSES  by  the  rows.  A blank  row  would 
designate  that  the  PROCESS  represented  by  that  row  is 
Independent  of  any  EVENTS  specified  in  the  matrix.  A 
Summary  section  would  also  be  included  to  present  statistical 
Information  about  the  matrix.  Another  section  would 
Interrelate  PROCESSES  and  EVENTS  with  INTERVALS  as 
specified  by  the  HAPPENS  statements. 
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SIZE  AND  VOLUME  ANALYSIS  OUTPUTS 


These  outputs  present  information  pertaining  to  the  usage  of  system 
parameters  in  the  user  requirement.  This  information  is  necessary 
in  estimating  data  storage  and  processing  requirements  during  the 
physical  design  phase  of  the  system  building  process.  The  data 
needed  to  derive  these  outputs  can  be  extracted  from  the  following 
URL  statements: 


CARDINALITY 

CONSISTS 

HAPPENS 

CONNECTIVITY 

These  outputs  serve  to  define  the  usage  of  system  parameters  in  the 
user  requirement  as  well  as  estimate  the  magnitude  of  the  system  in 
terms  of  amount  of  data  handled  and  amount  of  processing  required.  . 
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13.1  SYSTEM  PARAMETER  ANALYSIS  REPORT 

Purpose:  This  report  provides  the  user  with  a check 

of  the  context  in  which  each  system  parameter  was  used 
throughout  the  user  requirement.  It  is  intended  as  a 
tool  to  check  consistency  of  usage  and  of  conventions 
In  dealing  with  system  parameters.  For  example,  naming 
conventions  may  be  used  in  assigning  system  parameter 
names  which  should  be  kept  consistent  throughout  user 
requirement.  Inconsistency  might  also  occur  when  the 
same  system  parameter  name  (the  name,  N,  is  a good  example) 
may  be  unknowingly  used  to  represent  two  different  values 
It  Is  the  goal  of  this  output  to  present  such  information. 

Command:  At  present,  this  output  has  not  been  implemented  on  the 

URL/URA  system. 

Contents  and  Order:  For  each  system  parameter  name  this  output 

would  present  the  contexts  in  which  the  system  parameter 
has  been  used: 

Structure  size  - (via  CONSISTS  statement) 

Object  size  - (via  CARDINALITY  and  CONNECTIVITY  statements) 
Frequency  - (via  HAPPENS  statement) 


SYSTEM  PARAMETER  SIZE  REPORT 


Purpose:  To  relate  SYSTEM  PARAMETER  names  to  their  corresponding 

values.  This  aids  the  user  in  locating 
Inconsistencies  (a  SYSTEM  PARAMETER,  FIVE,  having  a value 
of  50)  and  incompleteness  (no  assigned  value  to  a 
particular  SYSTEM  PARAMETER  name.  After  the  user 
determines  that  the  system  parameter  definitions 
are  correct  this  report  can  become  a part  of  the  final 
specifications. 

Through  user  requirement  only  the  names  of  the  SYSTEM 
PARAMETERS  need  be  used.  At  the  appropriate  time  numerical 
values  may  be  assigned  to  these  names  via  the  VALUES 
statement  in  the  DEFINE  section. 

Command:  At  present,  this  output  is  not  available  on  the  URL/URA 

system. 

Contents  and  Order:  For  each  SYSTEM  PARAMETER  name  specified  in  the 

output  its  associated  numerical  value  or  value  range  will 
be  printed.  The  names  with  no  corresponding  values  will 
be  flagged. 


13.3  SET  SIZE  REPORT 


Purpose:  To  estimate  the  size  of  SETS  used  in  the  user  requirement. 

(When  a SET  corresponds  to  a file,  ENTITIES  may  be  thought 
to  correspond  to  records  in  the  file.)  The  estimate  is 
Important  in  the  early  stages  of  system  design  as  it 
directly  influences  the  physical  system  design  process. 

This  report  is  intended  as  a part  of  the  final  specifications 
of  the  logical  design  phase. 

The  output  will  present  the  use  of  SYSTEM  PARAMETERS  in 
relation  to  the  CARDINALITY  statements  in  the  SET  and 
ENTITY  sections  and  the  CONSISTS  statement  in  the  SET 
section.  Inconsistencies  in  the  use  of  SYSTEM  PARAMETERS 
for  establishing  SET  size  can  be  determined  and  evaluated. 

Command:  This  output  has  not  been  implemented  at  the  present  time. 

Contents  and  Order:  For  each  SET  specified  in  the  output  its 

CARDINALITY  statement  and  CONSISTS  statements  would  be 
printed.  The  CARDINALITY  statements  associated  with 
these  ENTITIES  used  in  the  CONSISTS  statements  would  also 
be  presented.  By  inspection  of  the  SYSTEM  PARAMETER 
values  associated  with  these  statements,  it  would  be 
trivial  to  produce  a numerical  s’ze  estimate  (in  terms  of 
ENTITIES)  of  the  SETS  and  determine  inconsistencies  and 
> incompleteness  through  the  assignment  of  these  values. 
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13.4  PROCESSING  VOLUME  REQUIREMENTS  REPORT 

Purpose:  To  provide  some  estimate  of  the  magnitude  of  the  processing 

workload  that  must  be  taken  into  account  by  the  physical 
system  design.  This  report  will  become  a part  of  the 
final  specifications  to  be  passed  on  to  the  physical  system 
designer.  The  volume  of  processing  can  be  estimated  by  the 
number  of  times  EVENTS  which  trigger  PROCESSES,  and  PROCESSES 
themselves,  occur  within  a given  time  INTERVAL.  Such 
Information  is  easily  extracted  from  the  HAPPENS  statements 
in  the  EVENT  and  PROCESS  sections. 

Command:  This  output  is  not  currently  available  on  the  URL/URA  system. 

Contents  and  Order:  For  each  PROCESS  specified  in  the  output,  any 

HAPPENS  statements  related  to  that  PROCESS  will  be  printed 
as  well  as  any  HAPPENS  statements  related  to  these  EVENTS 
which  TRIGGER  the  PROCESS.  Through  this  information  the 
total  number  of  times  a PROCESS  occurs  for  any  given 
INTERVAL  can  be  extracted.  Where  data  is  lacking  to 
present  these  statistics,  a warning  will  be  given  to  that 
effect. 
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14.  SYSTEM  PROPERTY  OUTPUTS 


These  outputs  specify  aspects  of  the  entire  system  not  presented 
by  the  previous  reports.  In  most  cases  this  will  mean  performing 
analysis  on  the  usage  of  ATTRIBUTES  throughout  the  user  require- 
ment. By  the  assignment  of  particular  ATTRIBUTE  names,  analysis 
can  be  performed  on  the  values  assigned  these  ATTRIBUTES  names  to 
extract  information  similar  to  the  way  in  which  the  previous  outputs 
extract  information  from  particular  URL  statements. 


i 
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14.1  ATTRIBUTE  REPORT 


Purpose:  To  present  the  values  assigned  to  ATTRIBUTE  names 

throughout  the  user  requirement  so  that  their  usage 
may  be  checked  for  consistency  and  accuracy.  For 
example,  given  an  ATTRIBUTE,  PROCESSING-MODE,  the 
two  values  for  it,  ON-LINE  and  INTERACTIVE,  may  be 
synonymous  in  this  application  and  so  the  terminology 
needs  to  be  made  consistent.  This  output  may  be  used 
as  a tool  for  the  analyst  in  locating  inconsistencies, 
etc.,  or  may  also  be  used  as  a quick  reference  in 
locating  all  objects  that  are  associated  with  a 
particular  ATTRIBUTE/ATTRIBUTE-VALUE  pair. 

Cotnnand:  Production  of  this  report  is  initiated  through  the 

PRINT-ATTRIBUTE-VALUES  command. 

Options:  Currently  no  options  are  available  that  change 

content  or  format  for  this  output. 

Contents  and  Order:  For  each  ATTRIBUTE  specified  in  the  report 

all  the  objects  it  is  related  to  in  the  user  requirement 
as  well  as  the  specific  value  the  ATTRIBUTE  takes  on  for 
that  object. 

Analysis:  The  process  of  implementing  this  report  involves  a basic 

retrieval  and  formatting  procedure. 
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14.2  COST/EFFECTIVENESS  REPORTS 


Purpose:  To  evaluate  the  cost/effectiveness  of  the  proposed 

system  (In  the  form  of  a user  requirement)  at  any  point 
in  the  user  requirement  definition  process.  These 
outputs  would  provide  management  and  analyst  the  opportunity 
of  "experimenting"  with  the  user  requirement  to  find  tne 
optimal  cost/effectiveness.  For  example,  if  at  one  point 
in  the  system  description  it  was  suggested  to  add  more 
functional  capabilities  at  higher  cost  the  use  of  the 
COST/EFFECTIVENESS  REPORTS  would  present  whether  or  not 
this  expansion  were  feasible. 

Command:  This  series  of  reports  is  not  currently  available  on 

the  URL/URA  system. 

Contents  and  Order:  This  information  is  intended  to  be  contained  in 

a package  of  reports  all  relating  to  various  aspects  of 
the  cost/effectiveness  problem.  A separate  paper  will 
fully  outline  the  contents  of  each  report  that  makes  up 
this  package. 
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15.  PROBLEM  ANALYSIS  OUTPUTS 


All  these  outputs  are  generated  in  an  attempt  to  improve  the  quality 
of  the  problem  statement  at  any  point  in  time.  It  is  the  task  of 
these  outputs  to  perform  complex,  special  analysis  to  locate 
ambiguitites,  inconsistencies,  and  incompleteness  in  the  problem 
statement.  All  objects  in  the  problem  statement  are  checked  for 
certain  criteria  particular  to  the  contect  in  which  they  are  used. 
For  example,  INPUTS  and  OUTPUTS  should  be  related  to  RWES  and 
PROCESSES  for  their  description  to  be  complete. 
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15.1  COMPLETENESS/CONSISTENCY  REPORT 

Purpose:  To  check  that  all  necessary  description  has  been 

specified  for  all  objects  in  the  user  requirement  at 
the  point  where  it  is  acceptable  as  final  specifications 
of  the  logical  design  phase.  This  is  intended  as  an  aid 
to  the  user  to  locate  incomplete  description  of  objects. 


Conmand:  This  report  is  not  currently  available  on  the  URL/URA 

system. 

Contents  and  Order:  The  report  will  consist  of  a series  of  warnings 
specifying  a particular  object  that  has  an  incomplete 
description.  Note  that  these  are  "warnings"  and  not 
"errors";  no  statements  are  mandatory  in  the  usage  of 
URL/URA.  A few  of  the  things  that  must  be  checked  are: 

- Data  such  as  ELEMENTS,  GROUPS,  ENTITIES,  SETS, 

INPUTS  and  OUTPUTS  interact  in  one  way  or  another 
with  one  or  more  PROCESSES. 

- EVENTS  are  related  to  INPUTS,  OUTPUTS  or  PROCESSES. 

- SYSTEM  PARAMETERS  and  ATTRIBUTES  have  values 
associated  with  them. 

- RUES  Interact  with  data  (INPUTS  or  OUTPUTS) 

Though  this  list  is  nowhere  near  exhaustive,  it  presents 
some  of  the  requirements  of  forming  a completeness/ 
consistency  report. 
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16.  PROJECT  MANAGEMENT  OUTPUTS 

These  outputs  are  intended  to  be  generated  for  and  used  by  the 
project  management  as  some  record  of  progress  in  the  use  of  URL/URA 
in  the  logical  system  design  phase.  The  outputs  present  various 
statistics  concerning  the  size  of  the  user  requirment  based  on  the 
number  of  relationships  specified  in  the  data  base  and  the  types 
of  relationships  which  have  been  specified.  For  example,  it  is 
possible  to  find  out  how  many  SYNONYMS  have  been  used  in  the  user 
requirement,  etc.  Each  new  URL  statement  added  to  the  data  base 
forms  new  relationships  between  objects  and  increases  the  size  of 
the  data  base. 
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16.1  DATA  BASE  STATISTICS 


Purpose:  To  present  various  statistics  on  the  number  of  relationships 

specified  in  the  data  base.  Progress  of  the  project  can 
be  evaluated  based  on  the  number  of  names  entered  into  the 
data  base  as  well  as  the  number  of  URL  statements  given  for 
these  names  (i.e.,  the  number  of  relationships  specified). 
The  output  is  intended  to  be  run  periodically  to  provide 
a hardcopy  of  the  project  progress  for  management. 

Command:  This  output  Is  generated  by  the  DATA-BASE-STATISTICS 

command. 

Options:  Nubs  represent  the  various  statements  in  URL.  It  is 

possible,  for  each  name  used  in  the  data  base,  to  receive 
a count  of  the  number  of  each  type  of  nub  associated  with 
that  name.  In  other  words,  it  is  possible  to  find  out  how 
many  KEYWORDS  a particular  name  has  by  looking  at  this 
output.  To  do  this,  the  NAMNUBS  parameter  must  be  specified. 
SYNONYMS  may  be  included  in  the  list  of  names  in  the  output 
but  relatively  little  information  is  gained  from  this  as 
SYNONYMS  have  no  nubs  directly  associated  with  them. 

Contents  and  Order:  The  first  section  consists  of  a list  of  all 

names  in  the  URA  data  base.  Associated  with  each  name  is 
first,  a numeric  code  that  signifies  its  name  type  (14  is 
equivalent  to  USER,  for  example)  and  then 
Information,  pertaining  to  the  relationships  the  name  is 
involved  in.  There  are  two  possible  relationships,  RELA 
or  RELB,  to  which  a name  can  be  associated.  Within  these 
relationships  are  various  types  of  connections:  NU3A, 

NUBB,  NUBC,  COM  and  OTHER.  All  numeric  data  beneath  these 
headings  correspond  to  counts  for  each  type  of  connection 
within  each  type  of  relationship.  TOT  presents  the  total 
number  of  relationships  specified  for  that  name  (or, 

RELA  + RELB).  The  names  from  tne  data  base  are  presen* °d 
In  alphabetical  order. 

The  second  part  of  the  output  Dresents  statistics  on  the 
usage  of  each  type  of  nub  (or  URL  statement)  in  the  URA 
data  base.  TYPE  specifies  a code  for  the  type  of  nub  and 
RELA  and  RELB  present  counts  of  the  types  of  relationships 
specified  for  that  type  of  nub.  Note  that  if  the  nub 
represented  a comment-entry  statement  only  a count  would 
be  available  for  RELA  and  RELB  would  equal  zero. 

Analysis:  Algorithms  are  used  to  maintain  counts  of  relationships 

between  names  and  URL  statements. 
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16.2  DATA  BASE  SUMMARY 

Purpose:  Presents  statistical  information  concerning  the  use  of 

each  name  type  possible  in  the  data  base.  This  output 
can  be  generated  periodically  to  measure  the  amount  of 
data  that  has  been  input  into  the  URA  data  base  over  any 
time  interval.  Some  degree  of  completeness  can  be 
estimated  also  as  this  output  presents  the  percentage 
of  names  which  have  DESCRIPTIONS  Included  in  user 
requirement,  the  better  the  quality  of  the  final  specifications. 

Command:  This  output  is  produced  through  usage  of  the  SUMMARY 

conmand. 

Options:  No  options  are  available  for  this  command. 

Contents  and  Order:  All  possible  name  types  in  the  data  base  are 

listed  in  alphabetical  order.  For  each  name  type  certain 
statistics  are  presented.  COUNT  is  the  number  of  occurrences 
in  the  data  base,  of  this  particular  name  type.  #W/SYN 
represents  the  number  of  these  occurrences  which  have 
SYNONYMS  assigned  to  them  and  PERCENT  specifies  this 
relationship  in  a percentage.  #W/DESC  represents  the 
number  of  these  occurrences  which  have  DESCRIPTIONS 
associated  with  them  and  PERCENT  specifies  this  relationship 
in  a percentage. 

Analysis:  The  generate  of  this  output  only  requires  the  algorithms 

to  perform  the  counts  and  then  to  format  them. 
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GLOSSARY 


analyst 
Analyzer 
data  base 

FIFO 

ISDOS  Working 
Paper  No.  100 

logical 

description 

logical  system 
design 

name  type 

physical  system 
design 

physical  system 
designer 

user 

user 

requirements 
proposed  system 
URA 

URA  data  base 


Name  used  synonymously  for  "user."  One  who  aids  to 
develop  the  user  requirement  or  logical  system  design. 

Synonym  for  "URA."  Is  the  software  package  that  processes 
requirements  stated  in  URL. 

Synonymous  with  "URA  data  base."  This  is  the  information 
sorted  and  retrieved  by  URA  by  means  of  the  Modifier  and 
Report  conmands. 

First  in,  first  out 

"Problem  Statement  Analyzer  Report  Generator  Facilities." 

A steop-by-step  guide  to  writing  own  reports  for  PSA. 

Synonym  to  "user  requirements."  Set  of  requirements  for 
a new  system. 

The  process  of  specifying  a user  requirement  for  any 
particular  system. 

Any  of  the  many  types  of  names  allowed  by  URL  (i.e., 
PROCESS,  SET,  GROUP,  etc.) 

The  process  of  specifying  a physical  system  (consisting 
of  software,  machinery,  etc.)  given  a particular  user 
requirement. 

Person  responsible  for  deriving  a physical  system  design 
from  the  user  requirement  generated  from  the  logical  system 
design  process. 

Used  synonymously  with  "analyst."  That  person  who  develops 
the  requirements  stated  by  the  users  into  a format  under- 
standable by  others  and  in  sufficient  detail  to  be  usable 
by  the  physical  system  designer.  The  product  of  this  work 
is  the  user  requirement. 

A set  of  requirements  specified  by  users  of  a proposed 
system  and  interpreted  by  the  user  into  a format  acceptable 
by  the  organization. 

Synonym  for  "target  system."  That  system  for  which  the 
user  requirement  is  being  developed. 

The  User  Requirements  Analyzer.  Synonym  is  "Analyzer." 
Software  package  which  retrieves  and  inputs  information 
to  the  URA  data  base. 

Area  where  URL  information  is  stored  (in  a coded  format) 
which  can  then  be  accessed  by  the  commands  allowed  by  URA. 


URA  "object" 


URL  statements 


system 

description 

target  system 


users 


Synonymous  with  "name  type."  Any  of  the  objects  that  can 
be  defined  by  URL  (a  SET,  a GROUP,  a ELEMENT  are  all 
objects  in  URA). 

Those  statements  specified  by  ISDOS  Working  Paper  No.  68. 
The  statement  presents  one  aspect  of  description  for  a 
particular  URA  "object." 

Synonymous  with  user  requirements  and  logical  description. 


Synonymous  with  proposed  system.  The  system  that  is  intended 
to  be  the  end  result  of  logical  and  physical  system  design. 

That  group  of  people  who  request  a system  or  those 
people  who  specify  the  requirements  for  a system  to  be 
built. 
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